home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / LW22.ZIP;1 / TXTMAN.ZIP / LW22.TXT
Encoding:
Text File  |  1994-04-20  |  150.6 KB  |  3,531 lines
  1.  Copyright    1/1 
  2.  
  3. LiveWire Communications Version 2.2
  4.  
  5. Professional Shareware Software
  6.  
  7. User Manual
  8. &
  9. Script Language Reference
  10.  
  11. Copyright 1990-1994 Les Novell
  12. DataMirage Software
  13.  
  14.  Introduction    2/1 
  15.  
  16. Introduction
  17. LiveWire Communications is the 32-bit, multi-threaded, text-based
  18. tele-communications program for OS/2 2.0 and later. Highly optimized, packed
  19. full of features, and yet easy to use, LiveWire is an excellent replacement for
  20. DOS communications packages which are unable to take full advantage of OS/2.
  21.  
  22. Features
  23. LiveWire's text-based interface is designed to be easy to use and configure,
  24. especially for users familiar with other communications software. LiveWire also
  25. has many features unavailable in other communications programs. The following
  26. is a list of major features incorporated in LiveWire 2.2.
  27.          
  28.  o Full TTY, ANSI, OS2You, VT-102, and 0+ Avatar  emulations
  29.  
  30.  o Integrated REXX scripting language
  31.  
  32.  o Data rates up to 57,600 bps without loss of data
  33.  
  34.  o High performance output in windowed and full screen sessions
  35.  
  36.  o Unlimited scroll-back buffer
  37.  
  38.  o 80 preset modem configurations to choose from
  39.  
  40.  o Internal public domain Zmodem-32 batch with resume
  41.  
  42.  o Named pipe support for network modems and connections
  43.  
  44.  o Point and shoot dialing directory with superior editing facilities
  45.  
  46.  o Macro commands control the actions of most function or alternate keys; all
  47.    keys are re-definable
  48.  
  49.  o Automatic detection and installation of external protocols such as M2Zmodem,
  50.    CKermit, SEALink, and ZedZap
  51.  
  52.  o Support for Procomm+, Qmodem, Boyan, Telix, and LiveWire keysets. This
  53.    feature is meant to decrease the time required to learn LiveWire by
  54.    providing familiar keycommand definitions.
  55.  
  56.  o Dialing directory reads and writes Procomm, Procomm+, Qmodem, Boyan, and
  57.    Telix dialing directories.
  58.  
  59.  o Point-and-shoot file selection, using a multi-threaded file navigator.
  60.  
  61.  Installation    3/1 
  62.  
  63. Installation
  64.  
  65.           To install LiveWire, first copy the source files from the
  66.           distribution diskette into a directory on your hard drive, for
  67.           example LW22. Then, change to that directory and drive and type
  68.           INSTALL.
  69.  
  70.           Example:
  71.  
  72.           C:\>mkdir LW22
  73.           C:\>A:
  74.           A:\>copy *.* C:\LW22
  75.           A:\>C:
  76.           C:\>cd LW22
  77.           C:\LW22>INSTALL
  78.  
  79.           The installation program will assume you want to install LiveWire in
  80.           the directory you have copied the files to. The installation program
  81.           will remove any previous residual configuration files. Next, it will
  82.           create a desktop folder for LiveWire which will contain the program,
  83.           this manual, a registration object, and a host mode script.
  84.  
  85.           Once installation has been completed, you may start LiveWire by
  86.           double-clicking on the LiveWire icon. If you have a registration
  87.           number you may register this copy of LiveWire by double-clicking on
  88.           the LiveWire key icon.
  89.  
  90.           If you have the ZIPed version of LiveWire available on bulletin
  91.           boards and networks world-wide, follow similar instructions, except
  92.           unzip the LiveWire ZIP file into the desired directory, then run
  93.           install.
  94.  
  95.  Running LiveWire for the first time    4/1 
  96.  
  97. Running LiveWire for the first time
  98.  
  99.           The first time LiveWire is started it must be told a few things about
  100.           the computer setup. The first thing LiveWire will want to know is
  101.           which communications port the modem is on. If you do not know which
  102.           port your modem is on you must refer to your modem or computer manual
  103.           for this information. Move the highlight bar to the correct
  104.           communications port using the right and left arrow keys, then press
  105.           ENTER to make a selection.
  106.  
  107.           Next, LiveWire must know what type of modem is installed in the
  108.           computer. A list of 80 different types of modems will be displayed.
  109.           To choose one, use the up and down arrow keys to move through the
  110.           list. Press ENTER on the modem installed. If the modem is not listed,
  111.           choose "Other modem not listed." In this case, additional setup will
  112.           be required. Refer to the modem manual for more information.
  113.  
  114.           LiveWire now needs to know the highest speed the modem will
  115.           communicate at. The correct speed will already be highlighted if a
  116.           pre-defined modem was selected. If "Other modem not listed" was
  117.           selected the modem speed should be set according to the modem manual.
  118.           Make the speed selection by moving the highlight bar to the correct
  119.           speed and then press ENTER.
  120.  
  121.           LiveWire will now prompt for a default color scheme. To select the
  122.           desired color scheme, use the arrow keys to move the highlight bar to
  123.           the color scheme desired and press ENTER. Colors can later be
  124.           customized.
  125.  
  126.           You will now be asked if you wish to emulate the keyset of several
  127.           popular communications programs. If you are not familiar with any of
  128.           these programs, just press ENTER. To emulate another program's
  129.           keyset, use the right arrow key to move the highlight bar to the
  130.           program of your choice and press ENTER.
  131.  
  132.           Lastly, you will be asked if you want to do some further
  133.           configuration or if you want to load LiveWire at this point. To load
  134.           LiveWire without any further configuration press ENTER, otherwise
  135.           press the right arrow key once to move the highlight bar to Edit
  136.           Configuration and then press ENTER.
  137.  
  138.  Configuration    5/1+
  139.  
  140. Configuration
  141. Using pull-down menus
  142.  
  143.           LiveWire makes use of pull-down menus in it's configuration.
  144.           Pull-down menus are designed for ease of use and brevity. Across the
  145.           top of the screen are several categories of configuration.
  146.  
  147.           Using the right and left arrow keys on your keyboard you can move the
  148.           highlight bar from one category to the next. Pressing the ENTER key
  149.           or Down arrow key on one of these categories "pulls down" a menu
  150.           pertaining to that category.
  151.  
  152.           Pressing ENTER while the highlight bar is on the Modem category
  153.           causes a menu appears directly under the category. In this new menu
  154.           are three options: "Port Configuration...", "Modem Commands...", and
  155.           "Install new modem..." The "..." at the end of these options indicate
  156.           they lead to additional nested menus.
  157.           Pressing the up and down arrow keys moves the highlight bar
  158.           vertically between the two options. Pressing ENTER on one of these
  159.           options leads to another nested menu.
  160.  
  161.           Under "Modem Commands..." is the final menu in the menu nest. Listed
  162.           in this menu are the several options for modem commands. Again, using
  163.           the up and down arrow keys moves the highlight bar among the options.
  164.           To change one of these options, move the highlight bar to the option
  165.           and press ENTER. A cursor will appear at the beginning of the option
  166.           which can be used to edit the field. When finished editing the field,
  167.           press ENTER or ESC and the cursor will disappear.
  168.  
  169.           Pressing the ESC key while not editing a field causes configuration
  170.           to back up one menu.
  171.  
  172.           If you get stuck or need a little instruction, there is one line of
  173.           context-sensitive help available at the bottom of each screen called
  174.           the status line. The status line contains status information and a
  175.           list of available options.
  176.  
  177.  Modem    6/2+
  178.  
  179. Modem
  180.           This menu contains three sub-menus used for configuring modem setup
  181.           and port setup. 
  182.  
  183.           "Port Configuration" is a sub-menu that contains specific hardware
  184.           information such as the communications port number and baud rate. 
  185.  
  186.           "Modem Commands" contains the modem's commands and responses such as
  187.           the commands that initialize the modem, dial a number, and hang up.
  188.           This menu also specifies the messages LiveWire will expect the modem
  189.           to respond with when it gets connected to another computer or
  190.           encounters a problem.
  191.  
  192.           "Install Modem" will install a different modem type from the list of
  193.           modems presented during initial configuration.
  194.  
  195.  Port Configuration    7/3 
  196.  
  197. Port Configuration...
  198. This selection leads you to a menu where you may change any of the options
  199. below.
  200.           Comm device
  201.                     Selecting this option allows you to change the
  202.                     communications port number your modem is using.  Refer to
  203.                     your modem, computer, or communications port manual for
  204.                     this information. It will not hurt to try numbers
  205.                     successively from 1 until your modem dials successfully. If
  206.                     you are using a named pipe for communication, this setting
  207.                     must be set to PIPE, which appears after COM8:.
  208.           Baud rate
  209.                     Selecting this option allows you to edit the speed your
  210.                     modem will operate at. This value can be anywhere from 110
  211.                     to 57,600. More common values of the baud rate are 1200,
  212.                     2400, 4800, and 9600, 19200, 14400, and 38400. Check your
  213.                     modem manual for the appropriate modem speed setting.
  214.           Data Bits
  215.                     Selecting this option switches the data bits to 7 or 8. IBM
  216.                     PC systems use 8 bits to communicate. Using a 7 bits is
  217.                     required by older hardware and mainframes. If 8 bits are
  218.                     used, the Parity setting must be None. If 7 bits are used,
  219.                     the Parity setting can be None, Even, or Odd.
  220.           Parity
  221.                     Selecting this option switches the parity to None, Even, or
  222.                     Odd. Parity is a form of error detection used by modems
  223.                     that communicate using 7 data bits. Since only 7 of a
  224.                     possible 8 data bits are used in a 7 bit communications
  225.                     session, the extra bit is used for error detection. There
  226.                     are three forms of this error protection LiveWire supports:
  227.                     None, Even, or Odd. Unfortunately, once an error has been
  228.                     detected, there is no way to correct it. Note that error
  229.                     means garbled text  produced from static or other noise
  230.                     caused by the phone lines.
  231.           Stopbits
  232.                     Selecting this option switches the number is stopbits to 1
  233.                     or 2. Stopbits are extra bits at the end of each series of
  234.                     8 bits that indicate the end of the series of bits. Most
  235.                     computer systems use 1 stop bit, although some require 2. 
  236.           Locked Port
  237.                     Selecting this option turns the locked port option off or
  238.                     on. If your modem has data compression you will want to
  239.                     turn this option on as well as telling your modem that you
  240.                     are using a locked port. Here is why: Most modems are
  241.                     "smart."  When they connect to another computer theyreturn
  242.                     a message to LiveWire indicating the speed at which they
  243.                     connect. For example, a modem may return CONNECT 2400. When
  244.                     the dialer receives this message, LiveWire normally resets
  245.                     the communications parameters to communicate at 2400 bps.
  246.                     While this is fine for modems without error compression,
  247.                     modems with data compression are able to boost transmission
  248.                     speeds well beyond 2400 bps.  For example, if your modem
  249.                     compresses a 2400 bps transfer by a factor of 2 then your
  250.                     actual transmission rate is twice that -- 4800 bps. Without
  251.                     a locked port LiveWire limits the connection to 2400 bps
  252.                     and no speed advantage is gained. Turning the Locked Port
  253.                     option ON prevents LiveWire from interpreting the modem's
  254.                     CONNECT 2400 message. Setting the Baud Rate option above to
  255.                     4800 then allows greater throughput. You must also set an
  256.                     option on your modem to lock the port (although this may be
  257.                     the default). For information on how to do this, consult
  258.                     your modem manual.
  259.           Named Pipe
  260.                     If you are attempting to connect to a named pipe server,
  261.                     you must set this field to the name of the pipe to connect
  262.                     to. All pipe names must begin with \PIPE\ and end in the
  263.                     remote computer name and remote pipe name. To use a named
  264.                     pipe the communications device must also be set to PIPE. 
  265.  
  266.  Modem Commands    8/3 
  267.  
  268. Modem Commands
  269.           This selection leads you to a menu where you may change any of the
  270.           options below.
  271.  
  272.  Modem Initialization
  273.                     Selecting this option allows you to change the modem
  274.                     initialization which is sent to the modem every time you
  275.                     start LiveWire.
  276.  
  277.                     Here are some other options you can add to the end of the
  278.                     string that work with most hayes-compatible modems:
  279.  
  280.                     E1        Set echo keystrokes on
  281.                     Q0        Quiet mode off
  282.                     M0        Modem speaker off
  283.                     V1        Verbose responses (such as CONNECT, BUSY)
  284.                     S7=60     Set dial timeout to 60
  285.                     X3        1200 baud busy signal/no dial tone checking
  286.                     X4        2400 baud busy signal/no dial tone checking
  287.                     &C1       Return correct online/offline status
  288.  
  289.                     There are many more commands the modem understands. The
  290.                     commands listed above are for 1200 and 2400 baud hayes
  291.                     compatible modems. Most modems are hayes compatible, or at
  292.                     least partially compatible. This manual cannot provide a
  293.                     complete list of modem commands since they do vary from
  294.                     modem to modem. If need be, review your modem's options in
  295.                     your modem manual. If you have a high speed or data
  296.                     compression modem make sure you read the manual to get the
  297.                     most out of your modem. It should have a list and
  298.                     description of all supported modem commands. 
  299.           Modem Dial Prefix
  300.                     Selecting this option allows you to change the dial command
  301.                     prefix. This is the command is required to initiate dialing
  302.                     of the phone. It is set to be ATDT by default, which means
  303.                     "ATtention, Dial Tone." If you have a pulse dial (rotary)
  304.                     phone, change this to ATDP, which stands for "ATtention,
  305.                     Dial Pulse." 
  306.           Modem Dial Postfix
  307.                     Selecting this option allows you to change the dial command
  308.                     postfix. Normally, this is just the ENTER key, which sends
  309.                     the command. The ENTER key is ^M for Control-M.
  310.           Modem Hangup Command
  311.                     Selecting this option allows you to change the hangup
  312.                     command. The hangup command for hayes compatible modems is
  313.                     ^~^~^~+++~^~^~^ATH0^M, which translates to:
  314.  
  315.                     ^~^~^~    Pause for 1.5 seconds (each ^~ is .5 seconds)
  316.                     +++       Puts the modem in command mode
  317.                     ^~^~^~    Pause for 1.5 seconds
  318.                     ATH0      Attention, hang up
  319.                     ^M        ENTER key (to send modem command)
  320.  
  321.                     NOTE: Before sending the modem hangup string LiveWire
  322.                     lowers the DTR signal. This will make many modems
  323.                     immediately hang up the phone. If this causes the modem to
  324.                     go off-hook, LiveWire does not send the hangup command.
  325.           Connect message
  326.                     Selecting this option allows you to tell LiveWire what your
  327.                     modem responds with when it connects with another computer.
  328.                     Hayes modems return CONNECT. Hayes smart modems will return
  329.                     the speed of connection along with the CONNECT response.
  330.                     (EG: CONNECT 2400). LiveWire is smart enough to understand
  331.                     these responses. You can prevent LiveWire from interpreting
  332.                     the bps rate following the connect message by turning the
  333.                     locked port option on.
  334.           Unable to connect #1,2,3,4
  335.                     Selecting these options allows you to tell LiveWire what
  336.                     messages your modem may return if it is unable to reach the
  337.                     number you have dialed. 
  338.           Modem error message
  339.                     Selecting this option allows you to tell LiveWire what
  340.                     error message the modem sends if something has gone wrong.
  341.                     It is simply ERROR for Hayes compatible modems.
  342.  
  343.  Terminal    9/2 
  344.  
  345. Terminal
  346. This menu contains configuration options related to terminal mode operation.
  347.  
  348.           Terminal Emulation
  349.           Selecting emulation lets you change which terminal type LiveWire will
  350.           emulate. The terminal type dictates how LiveWire will react to
  351.           special control codes and how it will act under certain situations. 
  352.  
  353.           TTY
  354.           Selecting this option will make LiveWire emulate TTY or TeleTYpe
  355.           emulation. TTY emulation is a plain vanilla emulation. It does
  356.           nothing special, simply displays what it receives.
  357.           ANSI
  358.           Selecting this option will make LiveWire emulate the ANSI emulation.
  359.           LiveWire's ANSI is a subset of the ANSI specification. Most bulletin
  360.           boards and online services use the ANSI emulation.
  361.           OS2You
  362.           OS2You is a special emulation designed to work only with OS2You
  363.           remote software. OS2You software, written by Mikael Wahlgren of Ridax
  364.           programming, is a shareware program that allows you to run OS/2
  365.           programs remotely -- over the network, or over a modem. OS2You
  366.           emulation is a modified ANSI emulation that has two special keys.
  367.           Pressing ALT-- (alt-minus, hex keycode 8200) switches between local
  368.           and remote keyboard. When local keyboard is on, LiveWire operates
  369.           normally. When remote keyboard is on, all special keystrokes are sent
  370.           to the remote program. This allows you to use function keys and
  371.           ALTkeys remotely. In addition, pressing ALT-= (alt-equals, hex
  372.           keycode 8300) causes the OS2You services menu to appear.
  373.           0+ Avatar
  374.           Selecting this option will make LiveWire emulate the Avatar 0+
  375.           specification. This specification, used widely on bulletin boards,
  376.           was created to increase the speed of ANSI text displays considerably.
  377.           VT-102
  378.           Selecting this option will make LiveWire emulate the DEC VT-102
  379.           terminal. DEC VT-102 terminal emulation was coded from the DEC VT330
  380.           programmer's manual and has been tested against several UNIX and VMS
  381.           systems as well as the public domain VTTEST program.
  382.  
  383.           Setup emulation...
  384.                     This option is only available if VT-102 is the current
  385.                     emulation. Thefollowing are settings for the VT-102
  386.                     emulation. The  default settings are those of a VT-102
  387.                     terminal, so usually no  configuration is required here.
  388.                     Backspace=DEL
  389.                               If Backspace=DEL is on then the backspace key
  390.                               always sends a DELETE character (0x7f) instead of
  391.                               the normal Backspace (0x8) character. This
  392.                               setting overrides the Off setting in the Defaults
  393.                               configuration menu.
  394.                     Destructive BS
  395.                               If Destructive BS is true, then backspace erases
  396.                               characters as it moves back one position. By
  397.                               default in VT-102 emulation backspaces are NOT
  398.                               destructive.
  399.                     Keypad
  400.                               Specifies current keypad mode. If the mode is
  401.                               numeric, the keypad sends actual numbers as the
  402.                               keys are pressed. If the mode is application,
  403.                               special escape sequences are sent to the remote
  404.                               computer.
  405.                     Cursor Keys
  406.                               Specifies the mode in which the cursor keys
  407.                               operate, application or normal. Cursor keys
  408.                               always send escape command sequences in VT-102.
  409.                     PFKeys
  410.                               Some programs which utilize VT-102 emulation
  411.                               require that four function keys (called PFKeys)
  412.                               be available. These keys can be mapped to one of
  413.                               three different local sets of keys, or they may
  414.                               be turned off. By default PFKeys are mapped to
  415.                               F1-F4, but can also be mapped to Shift F1-F4, Alt
  416.                               F1-F4, or CTRL F1-F4.
  417.                     Scroll end of line
  418.                               This option controls whether or not VT-102
  419.                               automatically scrolls when its output reaches the
  420.                               last column (the rightmost edge) on the screen.
  421.                     Command pacing
  422.                               This option controls the pacing, in milliseconds,
  423.                               between each character when a VT-102 escape
  424.                               sequence is sent from LiveWire to the remote
  425.                               site. This happens when PF-keys are pressed or
  426.                               arrow keys are used. The command pacing option is
  427.                               set to zero by default, but some remote hosts
  428.                               cannot handle escape sequences that are sent
  429.                               quickly. In this case this value must be
  430.                               increased.
  431.                     Tab setup...
  432.                               Tab locations can be changed with this option.
  433.                               Pressing ENTER on this option will bring up a
  434.                               window showing the current tabstops. A tab stop
  435.                               is indicated by a "T". Tab stops can be toggled
  436.                               of and on by going to the position desired and
  437.                               pressing ENTER. In addition, pressing ALT-S will
  438.                               restore the standard VT-102 tabs. Pressing ALT-C
  439.                               will clear all tab stops. When you are done
  440.                               editing tabs, press ESC to exit tab setup.
  441.                     Answerback message
  442.                               This string is the answerback message sent by
  443.                               LiveWire in response to a ENQuiry character. By
  444.                               default this message is "LiveWire 2.2."
  445.                     Answerback
  446.                               This setting indicates whether LiveWire should
  447.                               respond to the ENQuiry and send the Answerback
  448.                               message. By default this is yes.
  449.  
  450.           Echo Keystrokes
  451.                     Selecting this option turns LiveWire's echo (display) of
  452.                     keystrokes on or off. In terminal mode, if you press a key,
  453.                     LiveWire normally does not display the key on the screen.
  454.                     It relies on either the modem or the system you are calling
  455.                     to do this. However, in some cases you may want LiveWire to
  456.                     echo the keys back to you. In such a case you would turn
  457.                     Echo Keystrokes to ON.
  458.           Add linefeeds
  459.                     Selecting this option makes LiveWire either add linefeeds
  460.                     or not add line feeds to carriage returns. Normally, the
  461.                     modem or the other system you call will automatically drop
  462.                     down a line (linefeed) as well as carriage return (move the
  463.                     cursor to the beginning of the line). However, some systems
  464.                     only send carriage returns and expect LiveWire to add the
  465.                     linefeeds. In this case, Add linefeeds should be on.
  466.           Backspace is DEL
  467.                     Turning on this option makes LiveWire send a DEL character
  468.                     when the BackSpace key is pressed. Many dial-in services
  469.                     use DEL as a backspace character. If your BackSpace key
  470.                     does not work, try turning this option on.
  471.           Status Line
  472.                     Selecting this option turns the status line in the terminal
  473.                     on or off. The last line of your screen in terminal mode is
  474.                     normally used for status information. If the computer you
  475.                     are calling requires use of the whole screen, you should
  476.                     turn the status line off. 
  477.           VGA 50 line mode
  478.                     Selecting this option turns VGA 50 line mode on or off. If
  479.                     you have aVGA monitor, your monitor is capable of
  480.                     displaying 50 lines on your screen, as opposed to the
  481.                     normal 25. In this mode the dialing directory will display
  482.                     30 entries per screen rather than 10. 
  483.  
  484.           XON/XOFF flow control
  485.                     Selecting this option turns the XON/XOFF flow control
  486.                     protocol on or off. When XON/XOFF flow control is on, the
  487.                     receiving computer can send a command called XOFF to your
  488.                     computer that will stop transmission temporarily.  When the
  489.                     receiving computer catches up, it sends an XON command,
  490.                     which resumes transmissions. This is used when the computer
  491.                     is receiving information too quickly to be processed. If
  492.                     flow control is on and your computer receives the XOFF
  493.                     command, your keyboard will not work until XON is received.
  494.                     If you wish to override this, press the ESC key. 
  495.           RTS/CTS flow control
  496.                     Selecting this option turns the RTS/CTS flow control
  497.                     protocol on or off. The RTS/CTS protocol serves the same
  498.                     purpose as the XON/XOFF flow control but is more effective
  499.                     and more widely used. Flow control is managed by the
  500.                     hardware at the UART level instead of sending commands.
  501.                     This option should remain on for most modems, especially if
  502.                     you have a high speed modem. Without RTS/CTS flow control
  503.                     you may loose large chunks of information while
  504.                     communicating at high speeds.
  505.  
  506.           Ignore carrier signal
  507.                     The carrier signal is a signal sent by the modem to the
  508.                     computer informing the computer that the modem still has a
  509.                     connection. If this signal is suddenly dropped, LiveWire
  510.                     realizes that no connection exists any more and stops its
  511.                     current operation. Turning this option on causes LiveWire
  512.                     to ignore the state of the carrier signal when uploading
  513.                     and downloading. This is useful if you have a direct
  514.                     connection or your modem does not properly report carrier.
  515.  
  516.  Keys    10/2 
  517.  
  518. Keys
  519. This menu allows the setup of keyboard shortcuts (macros) and incoming/outgoing
  520. translation tables.
  521.  
  522.           Edit Macros...
  523.                     LiveWire's macros can be changed by selecting this option.
  524.                     LiveWire's macros control how the function keys operate.
  525.                     For example, when you press ALT-D, a macro is executed
  526.                     which makes the dialer screen appear. When you first select
  527.                     this option LiveWire will ask you to enter the macro
  528.                     filename. Press ENTER to retain the same macro filename.
  529.  
  530.           Macro char pacing
  531.                     This option determines the time, in milliseconds, to delay
  532.                     between sending each character in a macro. By default, this
  533.                     is zero.
  534.  
  535.           Press the function keys you wish to define or command below:
  536.                     Pressing any key or key combination here will allow you to
  537.                     define the macro associated with that key combination. You
  538.                     may define any key or key combination (except for normal
  539.                     typing or numeric keys). To do this, simply press that key
  540.                     or key combination. For example, Press F1. The macro for F1
  541.                     will be displayed, and you may edit it if you like. When
  542.                     you are done editing the macro, press ENTER. NOTE: In
  543.                     VT-102 emulation PF keys and keypad keys cannot be
  544.                     redefined.
  545.  
  546.           List macros
  547.                     Pressing L from this menu will display a full list of all
  548.                     definable keys and the macros associated with them. Using
  549.                     the up and down arrow keys you can move the highlight bar
  550.                     through the list of macros. Press ENTER to edit the
  551.                     highlighted macro.
  552.  
  553.           Using Macros
  554.                     Macros have many uses. Anything you put in the macros will
  555.                     be sent to the modem when you press the key associated with
  556.                     that macro. For example, if you define F1 to be "Hello, I
  557.                     am using LiveWire Communications!" then when you press F1
  558.                     it will be as if you typed "Hello, I am using LiveWire
  559.                     Communications!"  To insert control characters into the
  560.                     macro, use a caret followed by the control key letter. For
  561.                     example, ^M. Some common control characters and what they
  562.                     correspond to are:
  563.                               ^M        Carriage Return (as if you have pressed
  564.                                         ENTER)
  565.                               ^G        Makes a beep tone sound on the remote
  566.                                         computer
  567.                               ^L        Formfeed, which effectively clears the
  568.                                         screen
  569.                               ^[        Escape character
  570.                               ^         Placing a single caret at the end of a
  571.                                         line serves as a place marker for
  572.                                         trailing spaces. The ending caret will
  573.                                         not be transmitted
  574.  
  575.                     There are also commands that can go in macros. Commands are
  576.                     contained in curly braces -- { }. 
  577.  
  578.           The following macro commands are recognized by LiveWire:
  579.  
  580.           {BSISDEL}
  581.                     Toggles the action of the backspace key between the
  582.                     backspace  and
  583.                     delete character
  584.           {CAPTURE}
  585.                     Toggles capture of information on and off
  586.           {CGA25}
  587.                     Switches to 25 line mode
  588.           {CHANGE DIR}
  589.                     Invokes the change directory (directory tree) function
  590.           {CHANGE DRIVE}
  591.                     Invokes the change drive function
  592.           {CLRSCR}
  593.                     Clears the screen
  594.           {CONFIG}
  595.                     Invokes the configuration menu
  596.           {CONFIGEMU}
  597.                     Invokes the emulation configuration menu
  598.           {DIALER}
  599.                     Invokes the dialer
  600.           {DOORWAY}
  601.                     Toggles the doorway mode on and off
  602.           {DOS}
  603.                     Invokes a OS/2 command shell
  604.           {DOS:cmnd}
  605.                     Invokes a OS/2 shell where cmnd is executed
  606.           {DUMP SCREEN}
  607.                     Dumps the screen to a file (like print-screen)
  608.           {ECHO OFF}
  609.                     Turns local keyboard echo off
  610.           {ECHO}
  611.                     Toggles local keyboard echo on or off
  612.           {ECHO ON}
  613.                     Turns local keyboard echo on
  614.           {EGA43}
  615.                     Switches to 43 line mode
  616.           {EXIT}
  617.                     Exits LiveWire (asks the user before exiting)
  618.           {HANG-UP}
  619.                     Sends the command to hang up the modem
  620.           {HELPSCREEN}
  621.                     Brings up the help/command screen
  622.           {KEYCONFIG}
  623.                     Invokes macro configuration
  624.           {LEARN SCRIPT}
  625.                     Turns script learning on or off
  626.           {LINEFEEDS}
  627.                     Toggles local linefeeds on or off
  628.           {LINEFEEDS ON}
  629.                     Turns linefeeds on
  630.           {LINEFEEDS OFF}
  631.                     Turns linefeeds off
  632.           {LINES}
  633.                     Toggles between CGA 25 line and EGA 43 line screen mode
  634.           {LOG}
  635.                     Toggles the log on and off
  636.           {MACROCONFIG}
  637.                     Invokes macro configuration
  638.           {PASSWORD}
  639.                     Sends your password (as listed in the dialer) to the remote
  640.                     computer
  641.           {PRINTER}
  642.                     Toggles capture to printer on and off
  643.           {PORTCONFIG}
  644.                     Invokes the communications port configuration
  645.           {RECEIVE FILES}
  646.                     Invokes a download session
  647.  
  648.           {RUN SCRIPT <filename>}
  649.                     Invokes a script. If no filename is specified it is
  650.                     requested  from the user.
  651.                     If a filename is specified the script is immediately
  652.                     executed .
  653.           {SCROLL-BACK}
  654.                     Invokes scroll-back viewer
  655.           {SCROLL-BAK}
  656.                     Toggles scroll back on and off
  657.           {SEND FILES}
  658.                     Invokes an upload session
  659.           {SEND ANSI}
  660.                     Invokes the menu to send an ANSI color command to the remote
  661.                     computer
  662.           {SEND BREAK}
  663.                     Sends a BREAK signal to the remote computer
  664.           {STATUS}
  665.                     Toggles the status line on and off
  666.           {VIEW FILE}
  667.                     Invokes the file editor
  668.           {XFLOW OFF}
  669.                     Turns Xon/Xoff flow control off
  670.           {XFLOW}
  671.                     Toggles Xon/Xoff flow control on or off
  672.           {XFLOW ON}
  673.                     Turns Xon/Xoff flow control on
  674.           {XLATETABLES}
  675.                     Invokes translate tables configuration
  676.  
  677.                     You may mix commands and text. For example, a macro can be
  678.                     defined as:
  679.                     Running Configuration{CONFIG}Done.
  680.  
  681.                     Any of these commands can be embedded in a macro. These
  682.                     commands are dynamically linked with the command menu. If
  683.                     you move the clear screen command ({CLRSCR}) from  ALT-C to
  684.                     F1, the change will be reflected in the command screen
  685.                     automatically.
  686.  
  687.  Input translate table...
  688.                     Selecting this option will allow you to configure the
  689.                     translation table. The input translate table controls all
  690.                     information going and coming over themodem. Before it is
  691.                     displayed on your screen, it is passed through the
  692.                     translate table. For example, using the translate table you
  693.                     can change all A's to Z's or change all Z's to A's. The
  694.                     translate table lists numbers 0 through 255. Each number
  695.                     corresponds with a letter or character. For example, the
  696.                     number 65 corresponds with the letter A. Using this
  697.                     information, you can modify the translate table so that
  698.                     when the letter A is received it is changed to another
  699.                     letter. Note that the input translate table has no effect
  700.                     on special terminal emulation codes. 
  701.                               Swap
  702.                                         Pressing S, for swap, allows you to
  703.                                         view numbers 129 to 255 of the
  704.                                         translate table, since the screen can
  705.                                         only display 128 values at a time.
  706.                               Change
  707.                                         Pressing C, for change, allows you to
  708.                                         modify the translate table. You will be
  709.                                         asked which number you want to change.
  710.                                         For example, you would type in 65 and
  711.                                         press ENTER for the letter A. It then
  712.                                         asks you for the new value, any number
  713.                                         from 0 to 255. 
  714.                               View
  715.                                         Pressing V, for view, allows you to
  716.                                         view the letters and characters
  717.                                         associated with the numbers. Pressing V
  718.                                         again will return to the numeric mode.
  719.  
  720.  Output translate table...
  721.                     Selecting this option will allow you to configure the
  722.                     translation table. The output translate table controls all
  723.                     information going over the modem. Before it is displayed on
  724.                     your screen, it is passed through the translate table. For
  725.                     example, using the translate table you can change all A's
  726.                     to Z's or change all Z's to all A's. The translate table
  727.                     lists numbers 0 through 255. Each number corresponds with a
  728.                     letter or character. For example, the number 65 corresponds
  729.                     with the letter A. Using this information, you can  modify
  730.                     the translate table so that when the letter A is sent it is
  731.                     changed to another letter before being sent over the modem.
  732.                     See Input translate table for information on swap, change,
  733.                     and view commands.
  734.  
  735.  Protocols    11/2 
  736.  
  737. Protocols
  738. File transfer protocols may be configured using this menu.
  739.  
  740.           Zmodem-32 Batch
  741.           Zmodem setup options can be configured by selecting this option.
  742.           Auto-download
  743.                     Toggles Zmodem auto-download on or off. When Zmodem
  744.                     autodownload is on, Zmodem will automatically initiate a
  745.                     download when a packet header is seen.
  746.           32-bit CRC
  747.                     Toggles Zmodem 32-bit CRC checking on or off. When Zmodem
  748.                     32-bit CRC is off, Zmodem uses 16-bit CRC checking.
  749.           Rename files if FAT
  750.                     Toggles long filename renaming on FAT file systems on or
  751.                     off. If this option is off and a file with a long
  752.                     HPFS-style filename is downloaded to a FAT drive, the
  753.                     download will fail. If this option is on, a file with a
  754.                     long HPFS-style filename will be translated to the 8.3 FAT
  755.                     standard. Note that this translation is only done if the
  756.                     destination drive is FAT.
  757.           Rename duplicate files
  758.                     Toggles whether or not the file being received will be
  759.                     renamed if the filename already exists. LiveWire will first
  760.                     attempt to determine if the file transfer should be resumed
  761.                     by checking the file size. If the file on the disk compared
  762.                     to the file being received is smaller, LiveWire will
  763.                     attempt a resume the file transfer. If the file transfer
  764.                     cannot be resumed, the file is renamed.
  765.           Rename format
  766.                     This field specifies how incoming files will be renamed. By
  767.                     default the file's extension is removed and replaced with a
  768.                     unique number, starting with 1. If another format is
  769.                     required, this field can be modified to match that format.
  770.                     Any normal keys typed into this field at the keyboard will
  771.                     be added to the file. In addition, there are embedded codes
  772.                     which begin with a percent sign (%):
  773.  
  774.                     %f        Name of file being received, excluding extension
  775.                     %e        Extension of file being received
  776.                     %w        Whole name (name and extension) of file being
  777.                               received
  778.                     %n        A unique sequential number, assigned by LiveWire
  779.                     %%        Translates into a single percent sign
  780.                     Some examples of how this field might be used are:
  781.                     %f.%n    
  782.                               Translates filename "LW22.ZIP" into ("LW22.1" or
  783.                               "LW22.2" or "LW22.3", etc.)
  784.  
  785.                     %w;%n
  786.                               Translates filename "LW22.ZIP" into "LW22.ZIP;1"
  787.  
  788.                     Renamed file #%n %w
  789.                               Translates filename "LW22.ZIP" into "Renamed file
  790.                               #1 LW22.ZIP"
  791.  
  792.           Resume uploads
  793.                     Toggles whether or not Zmodem sends a resume request at the
  794.                     beginning of each upload. The receiver is responsible for
  795.                     determining whether or not the file should be resumed, and
  796.                     acts accordingly. NOTE: Leaving this option on will NOT
  797.                     cause problems uploading non-resumed files.
  798.  
  799.           Resume downloads
  800.                     Sets whether or not Zmodem attempts to resume a download.
  801.                     If this option is set to "off," Zmodem will never attempt
  802.                     to resume a download. If this option is set to "on," Zmodem
  803.                     will always attempt to resume transfer an existing file if
  804.                     the existing file is smaller than the file being received.
  805.                     If this option is set to "ask," LiveWire will ask before
  806.                     resuming any file. 
  807.  
  808.           Ascii
  809.           Ascii setup options can be configured by selecting this option.
  810.           Character pacing
  811.                     Sets the delay between characters, in milliseconds.
  812.           Line pacing
  813.                     Sets the delay after a CR or LF, in milliseconds.
  814.           Strip LF
  815.                     Toggles linefeed stripping on or off.
  816.           Strip CR
  817.                     Toggles carriage return stripping on or off.
  818.           CR -> CR/LF
  819.                     Toggles carriage return conversion to carriage return
  820.                     followed by linefeed on or off.
  821.           LF -> CR/LF
  822.                     Toggles linefeed conversion to carriage return followed by
  823.                     linefeed on oroff.
  824.           Expand blank lines
  825.                     If this option is on, empty lines are expanded so as to
  826.                     contain a single space. This is to avoid an empty line
  827.                     condition, which stops some editors.
  828.  
  829.           Edit external protocols
  830.           Selecting one of the protocols in the list will allow you to change
  831.           the information for that protocol. To add a new protocol you must
  832.           select the empty entry after the last protocol and provide the
  833.           following information:
  834.           Name
  835.                     Selecting this option allows you to change the name of the
  836.                     protocol. All protocols must be named.
  837.           Hotkey
  838.                     Selecting this option allows you to change the unique
  839.                     hotkey associated with the protocol. The hotkey is the
  840.                     character that may be pressed to automatically jump the
  841.                     highlight bar to that protocol. The hotkey should be one of
  842.                     the letters in the name of the protocol. This hotkey is
  843.                     also used to specify the protocol in the dialing directory
  844.                     and the script language.
  845.           Prompt filename
  846.                     Selecting this option changes whether LiveWire will prompt
  847.                     the user for a filename before downloads. If the protocol
  848.                     you are adding requires that LiveWire ask for the filename
  849.                     before receiving (downloading) a file, this option should
  850.                     be yes. Protocols such as Zmodem obtain the download
  851.                     filename from the sending computer automatically.
  852.                     Therefore, Zmodem does not require that the user enter a
  853.                     filename when receiving a file.
  854.           Receive command 1 and 2
  855.                     Selecting this option will allow you to change the OS/2
  856.                     commands required to run the protocol to receive a file.
  857.                     Read the external protocol manual for information about
  858.                     what command to use. Some protocols may require more than
  859.                     one DOS command, so two lines are provided. Most external
  860.                     protocols will require that you send the communications
  861.                     port, modem speed, and filename. If you put %0 in the
  862.                     command line, it will be replaced with the port number. %1
  863.                     will be replaced with the modem speed. %2 will be replaced
  864.                     with the filename or path. %3 is replaced with the file
  865.                     handle of the currently opened device.
  866.  
  867.                     Example:
  868.                     DSZ port %0 speed %1 rz %2
  869.                     May expand to:
  870.                     DSZ port 1 speed 2400 rz C:\TMPZIP
  871.  
  872.                     This replacement is done automatically by LiveWire, all you
  873.                     need to do is put the percent commands in the correct
  874.                     place.
  875.  
  876.           Send command 1 and 2
  877.                     Selecting this option will allow you to change the OS/2
  878.                     commands required to run the protocol to send a file. Read
  879.                     the external protocol manual for information about what
  880.                     command to use. Some protocols may require more than one
  881.                     DOS command, so two lines are provided. Most external
  882.                     protocols will require that you send the communications
  883.                     port, modem speed, and filename. If you put %0 in the
  884.                     command line, it will be replaced with the port number. %1
  885.                     will be replaced with the modem speed. %2 will be replaced
  886.                     with the filename or path.
  887.  
  888.                     Example:
  889.                     DSZ port %0 speed %1 rz %2
  890.  
  891.                     May expand to:
  892.                     DSZ port 1 speed 2400 sz C:\TMPZIP\READ.ME
  893.  
  894.                     This replacement is done automatically by LiveWire, all you
  895.                     need to do is put the percent commands in the correct
  896.                     place.
  897.  
  898.  Dialer    12/2 
  899.  
  900. Dialer
  901.  
  902.           Dialer on startup
  903.                     Turning this option on causes LiveWire to automatically
  904.                     enter the dialing directory when it starts up. By default
  905.                     this option is off and LiveWire enters terminal mode. This
  906.                     setting is turned off if a script is run from the command
  907.                     line.
  908.           Music on connect
  909.                     Turning this option off stops LiveWire from making sound.
  910.  
  911.           Popup on connect
  912.                     Turning this option on causes LiveWire's dialer to
  913.                     interrupt your current program by switching momentarily to
  914.                     full screen mode when a connection has been established. 
  915.  
  916.           Connect timeout
  917.                     Selecting this option allows you to change the time
  918.                     LiveWire will spend waiting to be connected to each
  919.                     computer system you dial. By default the connect timeout is
  920.                     set to 45 seconds. Most computers will establish connection
  921.                     within 15 to 20 seconds.
  922.  
  923.           Redial wait
  924.                     Selecting this option allows you to change how long
  925.                     LiveWire will wait between phone dialing attempts. By
  926.                     default it is set to five seconds. In other words, if
  927.                     LiveWire gets a busy signal it will wait five seconds
  928.                     before trying again.
  929.  
  930.           inter-character Pacing
  931.                     Most modems and network setups require a minuscule pause
  932.                     between characters sent to the modem. This option is the
  933.                     number of milliseconds LiveWire should pause between each
  934.                     character it sends to the modem. By default this option is
  935.                     set to 5 milliseconds. 
  936.  
  937.  Scroll-back    13/2 
  938.  
  939. Scroll-back
  940.  
  941.           Scroll-back
  942.                     Selecting this option turns the scroll-back buffer on or
  943.                     off. By default scroll-back is on. This means that LiveWire
  944.                     stores all text that scrolls off the screen for review. 
  945.           scroll-back Quote
  946.                     When quoting a portion of the text from your scroll back
  947.                     buffer, sometimes a character or characters to precede each
  948.                     line of quoted text. These characters indicate to the
  949.                     reader that the text he is reading has been quoted from
  950.                     another source. By default this option is a single caret
  951.                     (>).
  952.  
  953.           quote character Pacing
  954.                     This option sets the pacing (in milliseconds) between
  955.                     characters when quoting text from scroll-back. Some systems
  956.                     will require a pacing in order to keep up with the incoming
  957.                     information. By default, this value is zero.
  958.  
  959.  Colors    14/2 
  960.  
  961. Colors
  962. Under this configuration menu LiveWire's color scheme can be configured.
  963.  
  964.           Color schemes...
  965.           This sub-menu contains four pre-defined color schemes to choose from
  966.           Cool cyan
  967.                     This option selects a cyan (light blue) color scheme.
  968.           Moronic Monochrome
  969.                     This option selects a monochrome (black and white) color
  970.                     scheme.
  971.           Big Blue
  972.                     This option selects the traditional blue-on-grey color
  973.                     scheme. Looks great in a corporate office.
  974.           Neat-o Neon
  975.                     This option selects a wild neon-like color scheme.
  976.  
  977.           To do change a specific color select one of the options below. A
  978.           color selection box will appear. In the color selection box the up
  979.           and down arrow keys change the background color and the right and
  980.           left arrow keys to change the foreground color. A sample of the color
  981.           you've selected will appear. Press ENTER to select the color.
  982.           Terminal
  983.                     Selecting this option allows you to change the color in the
  984.                     terminal.
  985.           Terminal Message
  986.                     Selecting this option allows you to change the color of the
  987.                     messages displayed while in the terminal.
  988.           Menu text
  989.                     Selecting this option allows you to change the color of the
  990.                     normal menu text.
  991.           Menu Secondary text
  992.                     Selecting this option allows you to change the color of the
  993.                     secondary text in the menus.
  994.           Menu window Border
  995.                     Selecting this option allows you to change the color of the
  996.                     menu's border.
  997.           Menu Highlights
  998.                     Selecting this option allows you to change the color of the
  999.                     background highlights (scroll bars, for example) in the
  1000.                     menus.
  1001.           Status liNe
  1002.                     Selecting this option allows you to change the color of the
  1003.                     status line at the bottom of the screen.
  1004.  
  1005.  Paths    15/2 
  1006.  
  1007. Paths
  1008. Under the file configuration menu you can set up file paths and names.
  1009.  
  1010.           Editor
  1011.                     This field specifies the editor that LiveWire uses to view
  1012.                     and edit files. By default LiveWire uses OS/2's system
  1013.                     editor, E.
  1014.  
  1015.           Script path
  1016.                     This field specifies the default directory where scripts
  1017.                     can be found.
  1018.  
  1019.           Upload path
  1020.                     This field specifies the default directory from which
  1021.                     uploads (files to be sent) can be found. Normally this
  1022.                     option is blank, allowing the user to enter a path at the
  1023.                     time of the upload. 
  1024.  
  1025.           Download path
  1026.                     This field specifies the default directory where downloads
  1027.                     are sent. Normally this option is blank, allowing the user
  1028.                     to enter the path on each download. Protocols that do not
  1029.                     prompt you for a download file name (such as Zmodem) will
  1030.                     automatically use the download directory specified in this
  1031.                     field. If this field is empty the default directory is
  1032.                     used.
  1033.           Usage Log
  1034.                     This field contains the path and filename of LiveWire's
  1035.                     usage log file. If this is left empty, LiveWire will ask
  1036.                     for a log file name when the usage log is turned on.
  1037.           Capture file
  1038.                     This field contains the default path and filename for the
  1039.                     capture file. 
  1040.           Scroll back save
  1041.                     This field contains the default path and filename for
  1042.                     scroll back save.
  1043.           Screen Dump
  1044.                     This field contains the default path and filename for a
  1045.                     screen dump. A screen dump is saving the contents of the
  1046.                     current screen to a file. This is like print screen to a
  1047.                     file.
  1048.  
  1049.  Exit    16/2 
  1050.  
  1051. Exit
  1052.  
  1053. Save Configuration
  1054.                     Select this option to save the changes in the
  1055.                     configuration.
  1056.  Exit without saving
  1057.                     Select this option to cancel the changes made to the
  1058.                     configuration. Changes made to the macros and transfer
  1059.                     protocols cannot be canceled and will be in effect even if
  1060.                     you select abort configuration.
  1061.  
  1062.  The Terminal Mode    17/1 
  1063.  
  1064. The Terminal Mode
  1065.  
  1066. The modem initialization string
  1067.           When LiveWire first starts up it sends the modem initialization
  1068.           string. The modem initialization string is a set of commands sent to
  1069.           the modem that set it up for use by LiveWire Communications. 
  1070.  
  1071.           Before sending the initialization string, however, LiveWire checks to
  1072.           see if the modem is connected to another computer. If so, LiveWire
  1073.           will tell you that you are online and will ask if you still want to
  1074.           send the initialization string. Some modems will initially report
  1075.           that they are connected with another computer, but after sending the
  1076.           first initialization will report the correct status. In some
  1077.           occasions, the Hayes Personal Modem for example, the modem ALWAYS
  1078.           reports that it is connected to another computer. In this case
  1079.           LiveWire will always ask if you want to send the initialization
  1080.           string. You should answer Yes.
  1081.  
  1082.           If your modem was not listed as one of the pre-defined modems in the
  1083.           LiveWire modem database you should consult your modem manual for the
  1084.           correct settings. Some of the most common problems that occur if the
  1085.           modem initialization string is wrong are:
  1086.  
  1087.           Modem says "ERROR" (although the modem may still work correctly)
  1088.           Modem does not respond to commands
  1089.           Modem does not echo back keystrokes
  1090.           Modem responds with numbers instead of commands like OK, CONNECT, and
  1091.           BUSY
  1092.           Modem always indicates that is online
  1093.           Modem connects at the wrong speed
  1094.           LiveWire's dialer cannot dial
  1095.           LiveWire's dialer cannot recognize busy or connect signals
  1096.           LiveWire's dialer never gets a busy signal, but will connect
  1097.           LiveWire's dialer won't automatically detect the other modem's speed
  1098.  
  1099.  Explanation of the status line
  1100.           The last line on the screen is reserved for status information and
  1101.           help. In the terminal mode the status line looks like:
  1102.  
  1103.           | LW | COM1  2400 N81 | Offline |  8:19:24P | L P C E X F R B | ANSI
  1104.           |
  1105.  
  1106.           COM1                The communications device (COM1-8 or PIPE)
  1107.  
  1108.           2400                The modem speed
  1109.           N                   Parity: None, Even, or Odd
  1110.           8                   The data bits: 7 or 8
  1111.           1                   The stop bits: 1 or 2
  1112.           Offline             Indicates if the modem is offline or online. If
  1113.                               the modem is online, this will show the time
  1114.                               spent online.
  1115.           8:19:24P            The current time
  1116.           L                   Indicates LiveWire is keeping a log
  1117.           P                   Indicates LiveWire is capturing to the printer
  1118.           C                   Indicates LiveWire is capturing to a file
  1119.           E                   Indicates LiveWire is echoing local keystrokes
  1120.           X                   Indicates that XON/XOFF flow control is on
  1121.           F                   Indicates that linefeeds are on
  1122.           R                   Indicates that RTS/CTS flow control is on
  1123.           ANSI                Indicates the current terminal emulation
  1124.  
  1125.           In all other modes, such as the dialer, the status line contains
  1126.           limited help and available commands. 
  1127.  
  1128.  Terminal mode: a direct link to your modem
  1129.           The terminal mode serves as a direct link to your modem. Anything you
  1130.           type in terminal mode is sent to the modem. The modem has two modes:
  1131.           command mode and data mode.
  1132.  
  1133.           Initially, the modem is in command mode. While in command mode it
  1134.           will accept what's called Hayes AT commands. AT is short for
  1135.           "ATtention." Typing AT and then pressing ENTER should make the modem
  1136.           respond by printing OK on the screen. Some other commands are ATH for
  1137.           hangup and ATA for answer phone. In this command mode the modem
  1138.           interprets anything you type as a command.
  1139.  
  1140.           When the modem connects to another computer it automatically changes
  1141.           into data mode. In data mode the modem ignores all commands and opens
  1142.           a link between your computer and the other computer. Anything you
  1143.           type will be sent to the other computer.
  1144.           Once in data mode, there is a way to switch out of it -- type three
  1145.           +'s with a 1/2 second delay between each +. At this point, the modem
  1146.           will switch out of data mode and allow you to give it commands. It's
  1147.           unlikely you'll need to do this, because if either computer hangs up
  1148.           the phone the modem will return to command mode automatically.
  1149.  
  1150.  The Command Screen    18/1+
  1151.  
  1152. The Command Screen
  1153. LiveWire[Home]
  1154. Procomm+[Alt-Z]
  1155. Qmodem[Home]
  1156. Telix[Alt-Z]
  1157. Boyan[Ctrl-Home]
  1158.  
  1159. Using the command screen
  1160.           When LiveWire first loads up it will display the following line:
  1161.  
  1162.           Press <key> for menu command screen
  1163.  
  1164.           Pressing the key shown will bring up the command screen. The command
  1165.           screen provides a list to the major commands supported by LiveWire
  1166.           and the key combination which activates it.
  1167.  
  1168.           The command screen is important because the key combination
  1169.           associated with each command can change according to the macros
  1170.           setup.
  1171.  
  1172.           While in the command screen, pressing any of the listed key
  1173.           combinations will activate that command. Pressing the Escape key will
  1174.           return you to the terminal mode. You may also select the command you
  1175.           want by moving the highlight bar with the arrow keys, and then
  1176.           pressing ENTER when the highlight bar is on the command desired.
  1177.  
  1178.  Dynamic command keys and changing keysets
  1179.           All of LiveWire's command keys are dynamic. That is, you can
  1180.           configure the macros such that any key combination can bring up a
  1181.           desired function. For your convenience, LiveWire includes keyset
  1182.           emulations for LiveWire, Procomm+, Qmodem, Telix, and Boyan. This
  1183.           will help you adapt to LiveWire when switching from another
  1184.           communications program. All of the commands mentioned in this manual
  1185.           will, in fine print, list the keys for all of these keysets which
  1186.           activate the command.
  1187.  
  1188.           Changing the keyset emulations after the initial configuration of
  1189.           LiveWire is accomplished by bringing up the command screen and
  1190.           pressing K for keyset. Then press L for the LiveWire keyset, P for
  1191.           the Procomm keyset, Q for the Qmodem keyset, T for the Telix keyset
  1192.           or B for the Boyan keyset.  NOTE: changing the keyset clears the
  1193.           macros. If you have defined some macros for your personal use they
  1194.           will be erased by this command. You can also change the keys which
  1195.           activate any of the commands on the command menu right from the
  1196.           command menu. To do this, move the highlight bar to the command
  1197.           youwish to change and press N to select a new key combination. Then,
  1198.           press the key combination you wish to associate with the highlighted
  1199.           command. As long as that key combination is not used for another
  1200.           command the change will take place immediately and permanently on the
  1201.           command screen and in the LiveWire configuration.
  1202.  
  1203.  Phone book    19/2 
  1204.  
  1205. Phone book
  1206. LiveWire [Alt-D]
  1207. Procomm+[Alt-D]
  1208. Qmodem [Alt-D]
  1209. Telix [Alt-D]
  1210. Boyan [Alt-D]
  1211.  
  1212.           The phone book allows you to keep phone numbers of bulletin boards
  1213.           and online services. Directly from the phone book you can dial simply
  1214.           by moving the highlight bar to the number and pressing ENTER. 
  1215.  
  1216.           The dialer is able to read and modify Qmodem 4.x and 5.0, Procomm+,
  1217.           Telix, and Boyan phone files. Of course, LiveWire has it's own
  1218.           proprietary dialing directory format too. LiveWire has two
  1219.           proprietary dialing directory formats, 2.0 style and 2.1 style.
  1220.           Version 2.1 style allows much longer phone numbers and names and
  1221.           includes a comments section. Version 2.0 style retains compatability
  1222.           with the old DOS version of LiveWire. Note that DOS versions of
  1223.           LiveWire can only read 2.0 style phone books. The dialer also has
  1224.           excellent editing and sorting functions. For more information see the
  1225.           section The Phone Book.
  1226.  
  1227.  Clear screen    20/2 
  1228.  
  1229. Clear screen
  1230. LiveWire[Alt-C]
  1231. Procomm+[Alt-C]
  1232. Qmodem[Alt-C]
  1233. Telix[Alt-C]
  1234. Boyan[Alt-Z]
  1235.  
  1236.           This command simply clears the terminal mode screen.
  1237.  
  1238.  Scroll back    21/2 
  1239.  
  1240. Scroll back
  1241. LiveWire[UP-Arrow]
  1242. Procomm+[Alt-F6]
  1243. Qmodem[UP-Arrow]
  1244. Telix[Alt-B]
  1245. Boyan[Up-Arrow]
  1246.  
  1247.           Using the scroll-back command you may review what has scrolled off
  1248.           your screen during your connection. You may then save all or parts of
  1249.           this scroll-back buffer. 
  1250.  
  1251.           To review scroll-back you can press the up and down arrow keys. Doing
  1252.           this moves the white highlight bar up and down the screen. When the
  1253.           highlight bar reaches the top or bottom of the screen the screen will
  1254.           scroll automatically to reveal more of the session. 
  1255.  
  1256.  Clearing the buffer
  1257.           You can clear the scroll-back buffer by pressing C when it is
  1258.           activated.
  1259.  
  1260.  Saving the buffer
  1261.           Pressing S will allow you to save the scroll-back. You will be asked
  1262.           for a filename to save the scroll-back to. If you wish to save only
  1263.           part of the scrollback you can block highlight the part you want to
  1264.           save before pressing S.
  1265.  
  1266.  Marking a block of text for saving
  1267.           To preform block highlighting, move the highlight bar to the first
  1268.           line you wish to highlight. Press B, for Begin Block. Now move the
  1269.           highlight bar to the last line you wish to highlight. Press E, for
  1270.           End Block. Both the beginning line, ending line, and all lines in
  1271.           between will be highlighted. To save this highlighted block, press S.
  1272.  
  1273.  Quoting text from the buffer
  1274.           You can also quote a highlighted block. Quoting means that the
  1275.           highlighted block is transmitted over the modem, as if you typed it
  1276.           in yourself. One example of where this feature can be used is if you
  1277.           are replying to a message. If you wish to include some of the
  1278.           original message in your reply for reference purposes you can
  1279.           highlight just the lines you want from the original message and then
  1280.           have LiveWire retype it for you. To preform a quote, highlight the
  1281.           block you wish to quote and then press Q, for Quote.
  1282.  
  1283.  Searching for text in the buffer
  1284.           LiveWire also allows you to search for strings within the
  1285.           scroll-back. This is extremely useful for finding the desired
  1286.           position in a very long scroll backsession. To start searching, press
  1287.           F for find and type in a string to search for. LiveWire will search
  1288.           backwards, from the current highlight bar position to the top of the
  1289.           scroll-back buffer. When LiveWire finds the string it will move the
  1290.           highlight bar to the line in which the string was found and stop
  1291.           searching. If you wish to search for another occurrence of the string
  1292.           press A, for search again.
  1293.  
  1294.  Exiting the buffer
  1295.           When you are finished looking through the scroll-back you may exit
  1296.           back to terminal mode by pressing ESC.
  1297.  
  1298.  Capture    22/2 
  1299.  
  1300. Capture
  1301. LiveWire[Alt-K]
  1302. Procomm+[Alt-R]
  1303. Qmodem[Ctrl-Home]
  1304. Telix[Alt-L]
  1305. Boyan[Alt-L]
  1306.  
  1307.           This command will capture the whole communications session to a file.
  1308.           The capture can be turned off by repeating this command again.
  1309.  
  1310.  Dump screen    23/2 
  1311.  
  1312. Dump screen
  1313. LiveWire[Alt-U]
  1314. Procomm+[Alt-G]
  1315. Qmodem[Alt-T]
  1316. Telix[Alt-I]
  1317. Boyan[Alt-S]
  1318.  
  1319.           This command allows you to save the current terminal mode screen to a
  1320.           disk file.
  1321.  
  1322.  ANSI color    24/2 
  1323.  
  1324. ANSI color
  1325. LiveWire[Alt-A]
  1326. Procomm+[Alt-N]
  1327. Qmodem[Alt-7]
  1328. Telix[Alt-N]
  1329. Boyan[Alt-O]
  1330.  
  1331.           This command sends the correct ANSI codes over the modem to change to
  1332.           any desired color. This may be useful in messages and while chatting.
  1333.  
  1334.  Hang-up    25/2 
  1335.  
  1336. Hang-up
  1337. LiveWire[Alt-H]
  1338. Procomm+[Alt-H]
  1339. Qmodem[Alt-H]
  1340. Telix[Alt-H]
  1341. Boyan[Alt-H]
  1342.  
  1343.           This command attempts to hang up the modem. It attempts two methods.
  1344.           First, it lowers the DTR (Data Terminal Ready) signal for a 1/4
  1345.           second and raises it. Most modems will take this as a signal to
  1346.           hangup. If the modem fails to hangup using this method LiveWire sends
  1347.           a the hangup string to the modem instructing it to hang up the phone.
  1348.  
  1349.  Exit    26/2 
  1350.  
  1351. Exit
  1352. LiveWire[Alt-X]
  1353. Procomm+[Alt-X]
  1354. Qmodem[Alt-X]
  1355. Telix[Alt-X]
  1356. Boyan[Alt-X]
  1357.  
  1358.           This command exits LiveWire Communications. Before exiting, LiveWire
  1359.           will ask you if you're sure you want to exit. Press Y (or ENTER) to
  1360.           exit or N to return to LiveWire.
  1361.  
  1362.  Configuration program    27/2 
  1363.  
  1364. Configuration
  1365. LiveWire[Alt-N]
  1366. Procomm+[Alt-S]
  1367. Qmodem[Alt-N]
  1368. Telix[Alt-O]
  1369. Boyan[Alt-C]
  1370.  
  1371.           This command allows you change the configuration for LiveWire. 
  1372.           Configuration is explained in the section Configuration.
  1373.  
  1374.  Port setup    28/2 
  1375.  
  1376. Port setup
  1377. LiveWire[Alt-P]
  1378. Procomm+[Alt-P]
  1379. Qmodem[Alt-P]
  1380. Telix[Alt-P]
  1381. Boyan[Alt-P]
  1382.  
  1383.           This command allows you to change the serial port configuration. This
  1384.           includes COM port, baud rate, data bits, stop bits, parity, network,
  1385.           and port setup. This is discussed in the section Configuration
  1386.           options and explanations.
  1387.  
  1388.  Macros    29/2 
  1389.  
  1390. Macros
  1391. LiveWire[Alt-M]
  1392. Procomm+[Alt-M]
  1393. Qmodem[Alt-J]
  1394. Telix[Alt-K]
  1395. Boyan[Alt-M]
  1396.  
  1397.           This command allows you to configure the keyboard macro definitions.
  1398.           This is discussed in the section Configuration options and
  1399.           explanations.
  1400.  
  1401.  X-late Tables    30/2 
  1402.  
  1403. X-late Tables
  1404. LiveWire[Alt-T]
  1405. Procomm+[Alt-W]
  1406. Qmodem[Alt-A]
  1407. Telix[Alt-W]
  1408. Boyan[Alt-T]
  1409.  
  1410.           This command allows you to change the translate tables LiveWire uses.
  1411.           This is discussed in the section Configuration options and
  1412.           explanations. 
  1413.  
  1414.  Config keys    31/2 
  1415.  
  1416. Config keys
  1417. LiveWire[Alt-Y]
  1418. Procomm+[Alt-F8]
  1419. Qmodem[Alt-6]
  1420. Telix[Alt-2]
  1421. Boyan[Alt-K]
  1422.  
  1423.           This command allows you to configure the keyboard macros or translate
  1424.           tables. This is discussed in the section Configuration options and
  1425.           explanations.
  1426.  
  1427.  Set Emulation    32/2 
  1428.  
  1429. Emulation
  1430. LiveWire[Alt-E]
  1431. Procomm+[Alt-U]
  1432. Qmodem[Alt-G]
  1433. Telix[Alt-T]
  1434. Boyan[Alt-A]
  1435.  
  1436.           Sets the terminal emulation LiveWire uses. Currently, LiveWire
  1437.           supports TTY, ANSI, OS2You, and VT-100. Most bulletin boards and
  1438.           online services require or recommend ANSI emulation. For more
  1439.           information, see Terminal Emulations.
  1440.  
  1441.  Run script    33/2 
  1442.  
  1443. Run script
  1444. LiveWire[Alt-I]
  1445. Procomm+[Alt-F5]
  1446. Qmodem[Alt-F]
  1447. Telix[Alt-G]
  1448. Boyan[Alt-R]
  1449.  
  1450.           This command starts a LiveWire script file.  You will be asked for
  1451.           the filename of the script (including extension). You will then be
  1452.           asked for script parameters. If you do not know what script
  1453.           parameters to provide, just press ENTER.
  1454.  
  1455.  Learn script    34/2 
  1456.  
  1457. Learn script
  1458. LiveWire[Alt-L]
  1459. Procomm+[Alt-F10]
  1460. Qmodem[Alt-Q]
  1461. Telix[Alt-Y]
  1462. Boyan[Alt-8]
  1463.  
  1464.           This function attempts to learn your keystrokes and records your
  1465.           keystrokes in a script file for later playback. This feature is
  1466.           useful for automating redundant tasks such as typing your name and
  1467.           password to login to a system. For more information about script
  1468.           learning see Using Script Learn.
  1469.  
  1470.  Send files    35/2 
  1471.  
  1472. Send files
  1473. LiveWire[PgUp]
  1474. Procomm+[PgUp]
  1475. Qmodem[PgUp]
  1476. Telix[Alt-S]
  1477. Boyan[PgUp]
  1478.  
  1479.           This command lets you send files over the modem using any of the
  1480.           listed protocols. A discussion of how to send and receive files is
  1481.           found in the section Transferring files.
  1482.  
  1483.  Receive files    36/2 
  1484.  
  1485. Receive files
  1486. LiveWire[PgDn]
  1487. Procomm+[PgDn]
  1488. Qmodem[PgDn]
  1489. Telix[Alt-R]
  1490. Boyan[PgDn]
  1491.           This command lets you receive files over the modem using any of the
  1492.           listed protocols. A discussion of how to send and receive files is
  1493.           found in the section Transferring files.
  1494.  
  1495.  OS/2 shell    37/2 
  1496.  
  1497. OS/2 shell
  1498. LiveWire[Alt-S]
  1499. Procomm+[Alt-F4]
  1500. Qmodem[Alt-R]
  1501. Telix[Alt-J]
  1502. Boyan[Alt-J]
  1503.  
  1504.           This command temporarily shells you to an OS/2 command prompt. To
  1505.           return to LiveWire simply type EXIT and then press Enter at the DOS
  1506.           prompt.
  1507.  
  1508.  Change drive    38/2 
  1509.  
  1510. Change drive
  1511. LiveWire[Alt-G]
  1512. Procomm+[Alt-F9]
  1513. Qmodem[Alt-L]
  1514. Telix[Alt-3]
  1515. Boyan[Alt-7]
  1516.  
  1517.           This command allows you to change the logged drive. Simply move the
  1518.           highlight bar to the drive you want and press ENTER. You may also
  1519.           type the letter of the drive to change to, A through Z.
  1520.  
  1521.  Change dir    39/2 
  1522.  
  1523. Change dir
  1524. LiveWire[Alt-O]
  1525. Procomm+[Alt-F7]
  1526. Qmodem[Alt-O]
  1527. Telix[Alt-4]
  1528. Boyan[Alt-N]
  1529.  
  1530.           This command allows you to change the default directory by choosing
  1531.           it from the file navigator. The first time this command is run
  1532.           LiveWire will scan the disk to make the directory structure. This may
  1533.           take some time. 
  1534.  
  1535.  Directory    40/2 
  1536.  
  1537. Directory
  1538. LiveWire[Alt-R]
  1539. Procomm+[Alt-F]
  1540. Qmodem[Alt-W]
  1541. Telix[Alt-1]
  1542. Boyan[Alt-0]
  1543.  
  1544.           This command displays a listing of the files in the current directory
  1545.           by the OS/2 DIR /P command.
  1546.  
  1547.  View file    41/2 
  1548.  
  1549. View file
  1550. LiveWire[Alt-V]
  1551. Procomm+[Alt-V]
  1552. Qmodem[Alt-V]
  1553. Telix[Alt-A]
  1554. Boyan[Alt-V]
  1555.  
  1556.           This command invokes the external editor to edit a file of your
  1557.           choice. By default the OS/2 system editor E is invoked on the file.
  1558.  
  1559.  Send BREAK    42/2 
  1560.  
  1561. Send BREAK (NOT listed in command menu)
  1562. LiveWire[Alt-B]
  1563. Procomm+[Alt-B]
  1564. Qmodem[Ctrl-End]
  1565. Telix[Ctrl-End]
  1566. Boyan[Ctrl-End]
  1567.  
  1568.           This command will send a 1.5 second break signal to the remote
  1569.           computer. 
  1570.  
  1571.  Log    43/2 
  1572.  
  1573. Log
  1574. LiveWire[Alt-1]
  1575. Procomm+[Alt-F1]
  1576. Qmodem[Alt-0]
  1577. Telix[Alt-U]
  1578. Boyan[Alt-U]
  1579.  
  1580.           This turns the usage log on and off. LiveWire logs such things as
  1581.           time of connection to another computer, files transferred, functions
  1582.           executed, time online, when carrier was dropped, and when LiveWire
  1583.           was started and exited.
  1584.  
  1585.  Printer    44/2 
  1586.  
  1587. Printer
  1588. LiveWire[Alt-2]
  1589. Procomm+[Alt-L]
  1590. Qmodem[Alt-9]
  1591. Telix[Ctrl-@]
  1592. Boyan[Ctrl-PrtSc]
  1593.  
  1594.           This command turns the printer on or off. If on, anything appearing
  1595.           in the terminal mode is sent to the printer. It is like the capture
  1596.           command which saves the session, except to the printer.
  1597.  
  1598.  Echo    45/2 
  1599.  
  1600. Echo
  1601. LiveWire[Alt-3]
  1602. Procomm+[Alt-E]
  1603. Qmodem[Alt-E]
  1604. Telix[Alt-E]
  1605. Boyan[Alt-E]
  1606.  
  1607.           This command turns echo on or off. If echo is on, LiveWire displays
  1608.           every key that you type in the terminal mode on the screen as you
  1609.           type it. This is not always desirable because normally the modem and
  1610.           other computers do that for you automatically. If you see doubled
  1611.           characters on your screen you should turn echo off.
  1612.  
  1613.  Scroll-back    46/2 
  1614.  
  1615. Scroll-back
  1616. LiveWire[Alt-4]
  1617. Procomm+[Alt-1]
  1618. Qmodem[Alt-U]
  1619. Telix[Alt-5]
  1620. Boyan[Alt-2]
  1621.  
  1622.           This command turns the scroll-back on or off. Scroll-back is designed
  1623.           to use as little memory as possible, but if you plan to run LiveWire
  1624.           for a long time without exiting it is best to turn Scroll-back off to
  1625.           conserve memory.
  1626.  
  1627.  Xon/Xoff    47/2 
  1628.  
  1629. Xon/Xoff
  1630. LiveWire[Alt-5]
  1631. Procomm+[Alt-2]
  1632. Qmodem[Alt-Z]
  1633. Telix[Alt-6]
  1634. Boyan[Alt-3]
  1635.  
  1636.           This command turns XON/XOFF flow control on or off. If flow control
  1637.           is on, the computer you are talking to will be able to temporarily
  1638.           pause your transmission in order to catch up. This is rarely used,
  1639.           but can be useful. It can be a nuisance, too. Sometimes line noise or
  1640.           static upon hanging up will cause a burst of characters, one of which
  1641.           will be the code to stop transmission. This will lock your keyboard
  1642.           until you press ESC to override the command.
  1643.  
  1644.  Doorway    48/2 
  1645.  
  1646. Doorway
  1647. LiveWire[Alt-6]
  1648. Procomm+[Alt-3]
  1649. Qmodem[Alt-=]
  1650. Telix[Alt-=]
  1651. Boyan[Alt-4]
  1652.  
  1653.           This command turns the special doorway mode on or off. While in
  1654.           doorway mode, you will be able to send function and arrow keys over
  1655.           the modem. Normally, only printing characters (letters, numbers, and
  1656.           symbols) can be sent over the modem. Using the special doorway mode
  1657.           all other keys will be sent over the modem. The use of this mode
  1658.           requires that the other computer be able to recognize the codes for
  1659.           the function keys. Some message editors and remote DOS shells
  1660.           recognize the keys. The program that initiated this standard is
  1661.           DOORWAY. The shareware DOORWAY program, by Marshall Dudley, allows
  1662.           any text based program to be run on one computer and appear on
  1663.           another via a modem.
  1664.  
  1665.  Status Line    49/2 
  1666.  
  1667. Status Line
  1668. LiveWire[Alt-7]
  1669. Procomm+[Alt-4]
  1670. Qmodem[Alt--]
  1671. Telix[Alt-7]
  1672. Boyan[Alt-5]
  1673.  
  1674.           This command turns the terminal mode status line on or off. In some
  1675.           cases where the whole screen is needed, the status line, which takes
  1676.           resides on the last screen line, may not be desirable. 
  1677.  
  1678.  Linefeeds    50/2 
  1679.  
  1680. Linefeeds
  1681. LiveWire[Alt-8]
  1682. Procomm+[Alt-F3]
  1683. Qmodem[Shift-Tab]
  1684. Telix[Shift-Tab]
  1685. Boyan[Shift-Tab]
  1686.  
  1687.           This command turns linefeeds on or off. If linefeeds are on, LiveWire
  1688.           adds a linefeed to every carriage return. IE: It'll automatically
  1689.           drop down a line when the cursor moves to the beginning of the line.
  1690.  
  1691.  50 lines    51/2 
  1692.  
  1693. 50 lines
  1694. LiveWire[Alt-9]
  1695. Procomm+[Alt-6]
  1696. Qmodem[Alt-4]
  1697. Telix[Alt-9]
  1698. Boyan[Alt-G]
  1699.  
  1700.           This command toggles between 25 lines per screen and 50 lines per
  1701.           screen mode. 
  1702.  
  1703.  Backspace=DEL    52/2 
  1704.  
  1705. Backspace=DEL
  1706. LiveWire[Alt-0]
  1707. Procomm+[Alt-0]
  1708. Qmodem[Alt-1]
  1709. Telix[Alt-0]
  1710. Boyan[Alt-9]
  1711.  
  1712.           This toggles the BackSpace key between sending a BS (backspace)
  1713.           character and sending a DEL character. For most BBSs a backspace (the
  1714.           default) is required. Some systems (UNIX or VMS, in particular) may
  1715.           require a DEL character, though. If your backspace key appears not to
  1716.           work, use this command to toggle your backspace setting.
  1717.  
  1718.  The Phone Book    53/1+
  1719.  
  1720. The Phone Book
  1721. LiveWire [Alt-D]
  1722. Procomm+[Alt-D]
  1723. Qmodem [Alt-D]
  1724. Telix [Alt-D]
  1725. Boyan [Alt-D]
  1726.  
  1727. The jobs the phone book performs
  1728.           The dialer keeps a list of up to 200 phone numbers of other
  1729.           computers. The dialer keeps records such as computer name, number,
  1730.           last called, and number of times called. The dialer also preforms
  1731.           useful functions such as dialing the modem and establishing a
  1732.           connection to one of the services in the phone book. You can have the
  1733.           phone book redial a number or several selected numbers until it
  1734.           connects with another computer. Upon connection to another computer
  1735.           the dialer will return to terminal mode so you can communicate with
  1736.           the other computer.
  1737.  
  1738.  Entering a phone number    54/2 
  1739.  
  1740. Entering a phone number
  1741.  
  1742.           The basic thing you'll need to know to use the dialer is how to enter
  1743.           a new phone number into the list. You can do this by using the edit
  1744.           command in the dialer. 
  1745.  
  1746.           First, bring up the dialer by pressing the key combination Alt-D from
  1747.           the terminal mode. Now, using the up and down arrow keys, move the
  1748.           highlight bar to a blank entry in the phone book. Now press the "E"
  1749.           key, for Edit. 
  1750.  
  1751.           A window appears displaying information for the entry you've
  1752.           selected. The highlight bar appears at the top of the window over the
  1753.           "Name" field. Press ENTER to edit the name of the computer system to
  1754.           be added. Type in the name and press ENTER. Now press the down arrow
  1755.           key once, moving the highlight bar to the "Number" field. Press ENTER
  1756.           to edit the phone number. Type in the phone number and then press
  1757.           ENTER when you're finished.
  1758.  
  1759.           When entering the phone number the following keys have special
  1760.           meanings:
  1761.  
  1762.           ,         A comma will pause the phone for 1/2 a second. This is
  1763.                     useful when the modem must wait for before continuing to
  1764.                     dial, as some long distance phone companies and foreign
  1765.                     calls require.
  1766.  
  1767.           A - J     The letters A through J are called dial codes. Putting a
  1768.                     dial code in the phone number will cause LiveWire to expand
  1769.                     that dial code into a code you specify. For example, if you
  1770.                     type in as a phone number: A555-3218 LiveWire will look up
  1771.                     the dial code A. If it is defined by you, it will be
  1772.                     replaced. For example, in this instance if A is defined as
  1773.                     "9,," then the number would expand to 9,,555-3218. As you
  1774.                     might imagine, this could be useful when you switch between
  1775.                     a phone line that requires that you dial 9 before dialing
  1776.                     and one that does not. The dial codes can be defined
  1777.                     through the edit (D)ialing codes command, "D" from the
  1778.                     dialing menu.
  1779.  
  1780.           When you are finished entering this information you might also want
  1781.           to edit other information such as speed, parity, bits, stop bits,
  1782.           script, password, last call, total calls, protocol, emulation, and
  1783.           echo. 
  1784.  
  1785.  Loading another programs dialing directory    55/2 
  1786.  
  1787. Loading another programs dialing directory
  1788.  
  1789.           LiveWire provides a unique feature in that it allows you to directly
  1790.           load several other dialing directory formats. LiveWire supports
  1791.           LiveWire, Qmodem 4.x and 5.0, Telix, Boyan, Procomm 3.4.2, and
  1792.           Procomm+ phone directory types.
  1793.  
  1794.           To load one of these phone files, first enter the dialing directory
  1795.           (press Alt-D from the terminal mode). Now press the "L" key to Load a
  1796.           new phone directory. When you are prompted, type the path and name
  1797.           for the dialing directory you wish to load, then press ENTER.
  1798.  
  1799.           Loading a Telix directory requires one extra step. Since Telix phone
  1800.           files are of variable length, they must be converted to LiveWire
  1801.           format before it can be used. So, when you try to load a Telix phone
  1802.           directory LiveWire will prompt you to enter a name for the converted
  1803.           Telix file. Another problem with Telix phone files is that they are
  1804.           cut off after 200 entries. This is due to the fact that the LiveWire
  1805.           phone directory format does not support more than 200 entries.
  1806.  
  1807.           For all phone directories except Telix, the file is not automatically
  1808.           converted to LiveWire format. If you wish to convert the phone
  1809.           directory to LiveWire format (although it is not necessary), press
  1810.           the "N" to coNvert to LiveWire format. You will be asked for a name
  1811.           to convert the phone file to. 
  1812.  
  1813.  Dialing out    56/2 
  1814.  
  1815. Dialing out
  1816.  
  1817.           Once you have your phone directory set up, you can dial another
  1818.           computer. Dialing on LiveWire is very easy. Use the up and down arrow
  1819.           keys to position the highlight bar over the entry you wish to dial
  1820.           and press ENTER. LiveWire will automatically start dialing the
  1821.           selected number. If LiveWire is unable to connect for any reason, it
  1822.           will wait for a few seconds and redial automatically. This re-dialing
  1823.           process will repeat until either you press ESC and cancel the dialing
  1824.           or you establish connection with the other computer. Pressing ESC
  1825.           simply stops the dialing and returns you to the dialing directory. If
  1826.           the modem connects with another computer, the dialer will make a high
  1827.           pitched ring and display the message "Connect. Press any key..." Upon
  1828.           your pressing a key, LiveWire will return you to the terminal mode
  1829.           where you can talk directly with the remote computer.
  1830.  
  1831.  Marking entries to dial multiple phone numbers    57/2 
  1832.  
  1833. Marking entries to dial multiple phone numbers
  1834.  
  1835.           LiveWire can also dial any number of entries you choose until it
  1836.           connects with one of the computers. This is done by marking the
  1837.           entries you wish to dial. Marking is also very simple. Position the
  1838.           highlight bar on the entry you wish to mark for dialing. Press the
  1839.           space bar. A check mark will appear next to the entry, indicating the
  1840.           entry has been marked. Note that the highlight bar automatically
  1841.           moves down to the next entry. Repeat this process until all of the
  1842.           entries you want to dial have been marked. Now, position the
  1843.           highlight bar on the entry you want to dial first, and press ENTER.
  1844.           The dialing will begin. The dialing will cycle through the marked
  1845.           entries until a connection is established.
  1846.  
  1847.  Dialing commands    58/2 
  1848.  
  1849. Dialing commands
  1850.  
  1851. dial entry [ENTER]
  1852.           The Start Dial command will start re-dialing either the entry the
  1853.           highlight bar is on or, if there are marked entries, the marked
  1854.           entries will be dialed. The dialer will continue re-dialing until it
  1855.           connects with another computer. To stop dialing, press ESC.
  1856.  
  1857.  edit entry [E]
  1858.           The Edit entry command will allow you to edit the entry the highlight
  1859.           bar is on or the entries that are marked. When you edit an entry, a
  1860.           window will appear containing the current entry's information. The
  1861.           following information can be edited by moving the highlight bar to
  1862.           that option and pressing enter. 
  1863.  
  1864.           Name                The name of the BBS or service associated with
  1865.                               this entry.
  1866.           Number              The phone number of there BBS or service for this
  1867.                               entry.
  1868.           Speed               Speed to set the modem before dialing. This is
  1869.                               initially set to the highest baud rate available
  1870.                               for your modem.
  1871.           Parity              Parity to be used for the computer being called.
  1872.                               N=No Parity, O=Odd Parity, E=Even Parity.
  1873.           Bits                Number of data bits to be used when communicating
  1874.                               to the computer being called. This may be either
  1875.                               7 or 8.
  1876.           Stop (bits)         The number of stop bits to be used when
  1877.                               communicating to the computer being called. This
  1878.                               may be either 1 or 2.
  1879.           Duplex              This option is the same as the echo on/off
  1880.                               toggle. If duplex is FULL, echo is off. If duplex
  1881.                               is HALF, echo is on.
  1882.           Script              This field contains the name of the script file
  1883.                               associated with this entry. When LiveWire
  1884.                               connects to a service it checks if the script
  1885.                               field is filled in. If specified this script file
  1886.                               is started as soon as a connection has been
  1887.                               established. NOTE: If a script file is specified
  1888.                               that does not exist, LiveWire assumes it is
  1889.                               supposed to start script learning and create a
  1890.                               script file for automated logon. For more
  1891.                               information about this feature read Using Script
  1892.                               Learning.
  1893.           Password            You may put your password here for reference. In
  1894.                               addition this field corresponds to the macro
  1895.                               {PASSWORD} and can be accessed by LiveWire REXX
  1896.                               scripts.
  1897.           Protocol            If you wish to have a default protocol for this
  1898.                               service press ENTER while the highlight bar is on
  1899.                               this option. A pop-up menu will appear listing
  1900.                               all of the possible protocols. Movethe highlight
  1901.                               bar to the default protocol for this entry and
  1902.                               press ENTER. 
  1903.           Emulation           If you wish to have a default terminal emulation
  1904.                               for this service press ENTER while the highlight
  1905.                               bar is on this option. A pop-up menu will appear
  1906.                               listing the terminal emulations LiveWire
  1907.                               supports. Move the highlight bar to the default
  1908.                               emulation for this entry and then press ENTER.
  1909.           Info file           Specifies the name of the file used for
  1910.                               additional information. If you wish to create
  1911.                               additional information (such as comments or
  1912.                               script information) with this dialing directory
  1913.                               you may link a dialer entry with a filename. 
  1914.           Last call           LiveWire keeps the date of your last call to this
  1915.                               system. You may manually edit this field.
  1916.           Total calls         Total number of times you've called and
  1917.                               successfully been connected to this service.
  1918.  
  1919.  mark [SPACEBAR]
  1920.           This command will mark or unmark the entry with the highlight bar on
  1921.           it. If the entry is not marked, it will become marked. If the entry
  1922.           is marked, it will be unmarked. Marking entries allows you to do mass
  1923.           dialing, deleting, and editing.
  1924.  
  1925.           Note that the mark/unmark command moves the highlight bar to the next
  1926.           entry automatically. This is to provide "power marking." In other
  1927.           words, holding down the spacebar will continue highlighting
  1928.           consecutive entries as long as the spacebar is held down.
  1929.  
  1930.  multiple mark [M]
  1931.           Multiple mark is a very useful and versatile command. It allows you
  1932.           to mark entries by name, part of a name, or entry number. For
  1933.           example, if you press M a window will appear asking for what to
  1934.           search for. Typing in 1,5,7 will mark entries 1, 5, and 7. Here are
  1935.           some more examples:
  1936.  
  1937.           1,10,50,3           Marks entries 1, 10, 50, and 3
  1938.           1,5..20             Marks entries 1, and all entries 5 through 20
  1939.           1..20,25..200       Marks entries 1 through 20 and entries 25 through
  1940.                               200
  1941.           DataMirage          Marks all entries that contain "DataMirage"
  1942.           Data                Marks all entries containing "Data." Note that
  1943.                               this will match entries such as: "DataMirage,"
  1944.                               "The DATA Line," and "Dumb Data." There is no
  1945.                               differentiation between caps and lowercase.
  1946.           1,Data,5..20        Marks entry 1, all entries containing "Data," and
  1947.                               entries 5 through20.
  1948.  
  1949.  unmark all [U]
  1950.           This command quickly unmarks all entries. 
  1951.  
  1952.  delete entry [DEL]
  1953.           This command does just what it says -- deletes the highlighted or
  1954.           marked entries. This command will confirm deletion before it deletes
  1955.           the entry. After each entry is deleted, LiveWire will ask if you want
  1956.           to remove the blank entry and move the rest of the dialing directory
  1957.           up to fill the blank spot. 
  1958.  insert entry [INS]
  1959.           Pressing INS inserts a blank entry wherever the highlight bar may be.
  1960.           Note that the new entry is created using the current configuration
  1961.           information (ie: the modem speed, parity, bits, stopbits, duplex, and
  1962.           the default protocol).
  1963.  
  1964.  sort entries [S]
  1965.           This command will sort your phone book A through Z, Z through A, or
  1966.           by total calls. All empty entries will be moved to the end of the
  1967.           list.
  1968.  
  1969.  eXchange entries [X]
  1970.           Exchange entries is a simple command that exchanges positions of two
  1971.           entries in the phone book. Simply mark two entries (no more, no less)
  1972.           and then press X. The position of the entries will be swapped.
  1973.  
  1974.  compRess directory [R]
  1975.           This command removes all blank entries from the dialing directory and
  1976.           compresses all entries so that they are contiguous. This command will
  1977.           not rearrange your phone book, it just moves entries up into spots
  1978.           where blank entries used to be. 
  1979.  
  1980.  xFer entry info [F]
  1981.           This feature facilitates the exchange of phone numbers. This command
  1982.           sends basic information over the modem about the entry the highlight
  1983.           bar is on. This is useful when you want to tell someone the phone
  1984.           number of a BBS you like but do not want to type them the name or
  1985.           number. Simply go into your dialer, move the highlight bar to the
  1986.           entry you want to send them information about and press F. They will
  1987.           see on their end: 
  1988.           :::>DataMirage BBS  <#>(408) 578-5850  
  1989.           (2400-N-8-1)        NOTE: If your friend is using LiveWire
  1990.                               Communications also and he does not have this
  1991.                               number in his dialing directory LiveWire will
  1992.                               automatically ask him if he wants to add this
  1993.                               number to his dialing directory!
  1994.  
  1995.  Print entries [P]
  1996.           This command will print your phone book to your printer. Upon
  1997.           pressing P, LiveWire will verify that your printer is on PRN (LPT1:).
  1998.           If you printer is on another printer port, communications port, or
  1999.           you want to print to a file, simply type in the destination of phone
  2000.           book list. For example, LPT2: for printer port 2, COM1: for com port
  2001.           1, COM2: for com port 2, or FONBOOK.TXT to send the listing to a file
  2002.           called FONBOOK.TXT.
  2003.  
  2004.  Load other book [L]
  2005.           The load other phone book command will allow you to load or start
  2006.           another phone book. LiveWire can read LiveWire, Procomm, Procomm+,
  2007.           Qmodem 4.x and 5.0, Telix and Boyan phone directories. To load one of
  2008.           these phone books, just enter the path and name of the phone book. To
  2009.           start a new phone book, type in a new filename and a clean phone book
  2010.           will be made for you.
  2011.  
  2012.  coNvert to LW format [N]
  2013.           This command converts Boyan, Procomm, Procomm+, Qmodem 4.x/5.0, and
  2014.           LiveWire 2.0 phone directories to current LiveWire phone file format.
  2015.           First load the phone book you wish to convert. Then, press N and type
  2016.           in a new name to save the converted phone book as.
  2017.  
  2018.  undo last actions [!]
  2019.           This command accomplishes an undo of all of your previous commands up
  2020.           until the last time the dialing directory was saved to the disk. The
  2021.           dialing directory is saved automatically by LiveWire upon exiting the
  2022.           dialer or loading a new phone file. The undo command accomplishes its
  2023.           work by simply reloading the dialing directory without saving the
  2024.           current changes. 
  2025.  
  2026.  View script [V]
  2027.           This command brings up the editor on the file specified in the script
  2028.           field for the highlighted entry.
  2029.  
  2030.  edit Dial codes [D]
  2031.           This command allows you to edit the dialing codes A through J.
  2032.           Pressing C brings up a window with the letters A through J listed
  2033.           with an entry field beside each. If you put "9," in the dialing code
  2034.           A, whenever the letter A appears in thenumber LiveWire is dialing
  2035.           (eg. A578-5850) the A will be replaced with "9,".  In this way it is
  2036.           easy to define and change prefixes or postfixes on numbers. Defined
  2037.           dialing codes are listed at the top of the dialing directory. To exit
  2038.           the edit dialing codes window, press ESC.
  2039.  
  2040.  edit Comment file [C]
  2041.           This command brings up the editor on the file specified in the Info
  2042.           file field for the highlighted entry.
  2043.  
  2044.  Transferring Files    59/1 
  2045.  
  2046. Transferring Files
  2047.  
  2048.           The transfer of files over a modem is called uploading and
  2049.           downloading. Uploading is the action of sending a file. Downloading
  2050.           is the action of receiving a file. 
  2051.  
  2052.           Conventional phone lines and most data links are error prone. Static,
  2053.           echos, and unclean lines cause "garbage" to be transmitted. In order
  2054.           to transfer files, these errors must be corrected or your programs
  2055.           and data will be unusable.
  2056.  
  2057.           In order to catch these errors files are transferred with an error
  2058.           detection and correction scheme called a file transfer protocol. Both
  2059.           the remote and local sides must agree upon the protocol. Some common
  2060.           protocols are Zmodem, Ymodem, and Xmodem. Zmodem is by far the most
  2061.           efficient and robust protocol of these three. Zmodem and Ymodem allow
  2062.           you to send and receive multiple files at a time. A transmission of
  2063.           multiple files is called a "batch" file transfer.
  2064.  
  2065.           Sample upload session
  2066.  
  2067.           This section describes uploading a file to a remote system. Here we
  2068.           assume that the remote system is capable of initiating the transfer
  2069.           on its side.
  2070.  
  2071.           First, locate the file on your disk that you want to send. The
  2072.           filename to send might be C:\LW22\LW22.EXE. 
  2073.  
  2074.           Next, tell your remote that you wish to send a file. Usually this is
  2075.           done by telling it you want to upload. Then, tell the remote which
  2076.           protocol you want to use. The most preferable protocol is Zmodem. For
  2077.           more information, consult the manual or help system for your remote
  2078.           host.
  2079.  
  2080.           When the remote end tells you to begin uploading, press the PageUp
  2081.           (for UPload) key on your keyboard. A list of protocols will appear
  2082.           for your to choose from. Choose the protocol that matches the one you
  2083.           selected for your remote.
  2084.  
  2085.           Once a protocol has been established, you will be prompted for the
  2086.           files you wish to send. If the protocol is Xmodem, Xmodem CRC, or
  2087.           Xmodem-1K youcan only send one file. If the protocol is Zmodem or
  2088.           Ymodem you may enter as many files as you wish. Optionally, you may
  2089.           use the file navigator to pick files to send from a list. Refer to
  2090.           the section File Navigator for more information. When you are
  2091.           finished entering files you can begin the transfer by pressing ENTER.
  2092.  
  2093.           During the file transfer a small window should appear in the lower
  2094.           right hand corner of your screen showing you statistics about the
  2095.           file transfer. To abort the file transfer, press ESC at any time.
  2096.           When the file transfer is completed the window will disappear and a
  2097.           bell will sound.
  2098.  
  2099.           Sample download session
  2100.           This section describes downloading a file from a remote system. Here
  2101.           we assume that the remote system is capable of initiating the
  2102.           transfer on its side.
  2103.  
  2104.           First, find the filenames or filenames you want on the remote side.
  2105.  
  2106.           Next, tell the remote that you wish to receive some files. Usually
  2107.           this is done by telling it you want to download. Then, tell the
  2108.           remote which protocol you want to use. The most preferable protocol
  2109.           is Zmodem. For more information, consult the manual or help system
  2110.           for your remote host.
  2111.  
  2112.           The remote end will ask you which files you want to download. Type in
  2113.           the filenames you wish to receive and tell the remote to begin the
  2114.           transfer.
  2115.  
  2116.           At this point, if you are using Zmodem the downloading will
  2117.           automatically begin. If you are downloading using Ymodem or Xmodem
  2118.           some extra work is required.
  2119.  
  2120.           The Ymodem protocol will not start up automatically, so you must
  2121.           press the Page Down key (for Download) and select the Ymodem
  2122.           protocol. At this point the download will begin.
  2123.  
  2124.           The Xmodem protocol (including CRC and 1k) will only receive one file
  2125.           at a time and does not start automatically either. To begin
  2126.           downloading you must press the PageDown key (for Download) and select
  2127.           the Xmodem protocol. You will then be prompted for a filename to
  2128.           download to. Type in one filename, and press ENTER. At this point the
  2129.           download will begin.
  2130.  
  2131.           During the file transfer a small window should appear in the lower
  2132.           right handcorner of your screen showing you statistics about the file
  2133.           transfer. To abort the file transfer, press ESC at any time. When the
  2134.           file transfer is completed the window will disappear and a bell will
  2135.           sound.
  2136.  
  2137.  File Navigator    60/1 
  2138.  
  2139. File Navigator
  2140.  
  2141.           Navigator features
  2142.           LiveWire 2.2 contains a new feature called the File Navigator. The
  2143.           File Navigator is a file and directory selection window with a
  2144.           multi-threaded interface capable of handling long file and directory
  2145.           names. File Navigator can be used to select files to upload, find a
  2146.           file from a file spec window, or change directories. 
  2147.  
  2148.           Initiating the navigator
  2149.           The navigator may be used in three different areas in LiveWire. 
  2150.  
  2151.           1. During batch uploads the batch send window will prompt for a
  2152.           filename. Pressing F3 in this window brings up the file navigator. 
  2153.  
  2154.           2. Any file specification window (IE: Load phone book, run script,
  2155.           view file, save scroll-back, capture file, etc) is capable of
  2156.           invoking the file navigator. Pressing F3 or ALT-N in a file
  2157.           specification window brings up the file navigator.
  2158.  
  2159.           3. The "Change dir" command brings up the file navigator
  2160.           automatically for directory selection.
  2161.  
  2162.           When the navigator is initiated it contains two main windows. The
  2163.           window on the right contains the files for the current directory. The
  2164.           longer window on the left contains a directory tree structure. When
  2165.           the navigator is first started files are displayed for the current
  2166.           directory while the directory tree structure is being built in the
  2167.           background. While the directory tree is being built, the files window
  2168.           may be used to select files and move between directories.
  2169.  
  2170.           Navigating the files window
  2171.           The file window contains at most two columns of files. If more files
  2172.           exist, an arrow will appear at the lower right hand corner of the
  2173.           files window.
  2174.  
  2175.           Using the Arrow, PgUp, PgDn, and Home keys the highlight bar may be
  2176.           moved over any file in the list. The highlight bar will also jump
  2177.           directly to a specified file by pressing the first letter of the
  2178.           filename on the keyboard. For example, pressing L might bring the
  2179.           highlight bar to the file LW22.ZIP.
  2180.  
  2181.           Once the highlight bar is over a file it may be selected by pressing
  2182.           ENTER.When multiple files can be selected, pressing the spacebar puts
  2183.           a mark next to the currently highlighted file. Marking several files
  2184.           in this way, then pressing ENTER causes all of the files to be
  2185.           selected.
  2186.  
  2187.           Directories in the file window are denoted by <DIR> after the
  2188.           directory name. Pressing ENTER while the highlight bar is over a
  2189.           directory causes the navigator to enter that directory. The special
  2190.           directory called ".." is available in all directory listings.
  2191.           Pressing ENTER while over ".." causes the navigator to leave the
  2192.           current directory and go back to its parent.
  2193.  
  2194.           Pressing the Tab key will change windows to the directory tree
  2195.           window.
  2196.  
  2197.           Navigating the directory tree window
  2198.           The window on the left is a tree-like blow-out of the directories on
  2199.           the hard drive. If the tree is wider than the window, only partial
  2200.           directory names will be visible. A scroll-bar on the right indicates
  2201.           the position of the highlight bar in relation to the entire directory
  2202.           tree structure.
  2203.  
  2204.           The directory tree may be traversed by pressing the Arrow, PgUp,
  2205.           Pgdn, Home and End keys to move the highlight bar. If the highlight
  2206.           bar is at the top or bottom of the window, the directory tree will
  2207.           scroll to bring more directories into view. As the highlight bar
  2208.           moves through the directory tree files for each directory to appear
  2209.           in the files window on the right.
  2210.  
  2211.           To change to another drive, press D. A list of valid drives will
  2212.           appear. Press the letter of the drive to change to.
  2213.  
  2214.           If a directory needs to be selected (as opposed to a file), pressing
  2215.           ENTER will select the highlighted directory.
  2216.  
  2217.           Pressing the Tab key will change windows to the files window.
  2218.  
  2219.           Exiting the file navigator
  2220.           Once the desired file(s) or directory has been located, pressing
  2221.           ENTER selects those directories and exits the file navigator. To exit
  2222.           the navigator without selecting a file or directory, press ESC.
  2223.  
  2224.  File Transfer Monitor    61/1 
  2225.  
  2226. File Transfer Monitor
  2227.  
  2228.           Included in the LiveWire 2.2 package is a Presentation Manager File
  2229.           Transfer Monitor. The file transfer monitor was designed so that
  2230.           background file transfers could be easily monitored while using the
  2231.           applications in the Work Place Shell.
  2232.  
  2233.           To start the file transfer monitor, double click on its icon before
  2234.           beginning the file transfer. You may also choose to keep the file
  2235.           transfer monitor running all the time as a minimized window. When
  2236.           minimized, the file transfer window changes its title to show the
  2237.           percent transferred of the current file.
  2238.  
  2239.           The file transfer monitor takes up very little memory and almost no
  2240.           CPU. It may be minimized or displayed even when LiveWire is not
  2241.           active.
  2242.  
  2243.           When a LiveWire session detects the presence of the file transfer
  2244.           monitor it connects through a named pipe. The named pipe remains
  2245.           connected until LiveWire exits or the file transfer monitor is
  2246.           closed.
  2247.  
  2248.           Please note that the file transfer monitor is a simple utility for
  2249.           the text-based version of LiveWire. It by no means attempts to make
  2250.           LiveWire a PM application, and is in no way related to the PM version
  2251.           of LiveWire currently being developed.
  2252.  
  2253.  Named Pipes    62/1 
  2254.  
  2255. Named Pipes
  2256.  
  2257.           Named pipes are a communications facility provided by OS/2. Named
  2258.           pipes connect two different programs through a data pipe in the
  2259.           computer. The data pipe can be thought of as a real-world pipe with
  2260.           two people standing on either end. If one person speaks down the
  2261.           pipe, the other person hears what the other has to say, and
  2262.           vice-versa.
  2263.  
  2264.           One use for named pipes can be used to connect your local computer to
  2265.           a single modem in a modem pool (collection of many modems). This is
  2266.           useful if there are a lot of employees and only a few modems.
  2267.           Employees can use a modem through named pipe, effectively sharing
  2268.           them with everyone in the company.
  2269.  
  2270.           Named pipes are also used for running programs remotely. OS2You by
  2271.           Mikael Wahlgren of Ridax programming allows you to run and control a
  2272.           program on a distant computer. The program can be run over a named
  2273.           pipe.
  2274.  
  2275.           To set up a connection to a named pipe in LiveWire two things must be
  2276.           set up in the port configuration. First, go into the configuration
  2277.           program under "Modem" and "Port Setup." Then, change your
  2278.           communications device to PIPE. Lastly, set the "Pipe Name" field to
  2279.           the name of the pipe you want to connect to.
  2280.  
  2281.           Pipe names always are of the format \PIPE\<pipename>.
  2282.           To access network pipes the pipe name format is
  2283.           \\<computername>\PIPE\<pipename>.
  2284.  
  2285.           When you exit configuration LiveWire will attempt to connect to the
  2286.           named pipe. If the connection attempt is unsuccessful the message
  2287.           "PORT NOT READY" will appear on the status line and the status line
  2288.           will say "Offline". If the connect is successful, the time spent
  2289.           connected will be displayed on the status line.
  2290.  
  2291.           To disconnect from a named pipe connection, press the hangup key
  2292.           sequence, usually ALT-H. A window saying "Disconnecting pipe" will
  2293.           appear, and the status line should read "Offline." If, during a
  2294.           connection, the remote disconnects the pipe the status line will
  2295.           report that you are "Offline".
  2296.  
  2297.           To attempt a re-connection to a named pipe, press the hangup key
  2298.           sequence again (usually ALT-H). A window saying "Attempting to
  2299.           reconnect pipe" will appear. If the connect was successful, the
  2300.           status line will indicate the connection has been established by
  2301.           displaying the time connected.
  2302.  
  2303.           For more information on how to setup named pipes refer to your
  2304.           remote's manual or online help.
  2305.  
  2306.  REXX Scripting Functions    63/1+
  2307.  
  2308. REXX Scripting Functions
  2309.  
  2310. Starting a script
  2311.           LiveWire includes support for the OS/2 REXX procedure language.
  2312.           LiveWire scripts may be started in one of three ways. Scripts may be
  2313.           started using the command line parameter /Sscriptname where
  2314.           <scriptname> is the name of the script to start. Scripts may be
  2315.           started from within LiveWire in two ways, by invoking them from the
  2316.           terminal mode or by linking them to a dialing entry. When the dialer
  2317.           makes a connection to a particular service, its script is
  2318.           automatically started.
  2319.  
  2320.  Description of functions
  2321.           REXX is a very powerful script language provided with OS/2. LiveWire
  2322.           extends the power of REXX by providing a full suite of functions
  2323.           designed to control communications sessions. Beneath this item is a
  2324.           list of functions that are added to REXX scripts executed inside
  2325.           LiveWire. 
  2326.  
  2327.           There are two special commands, GetLW and SetLW, which get and set
  2328.           LiveWire attributes. An attribute is any toggle or setting
  2329.           configurable in LiveWire. These attributes include cursor location,
  2330.           screen color, phone book entries, timeout values, terminal
  2331.           emulations, capture, and log. A complete list and description of all
  2332.           attributes are available beneath the SetLW function.
  2333.  
  2334.           The rest of the commands handle LiveWire functions, such as hanging
  2335.           up, dialing, and exiting. Complete descriptions are given beneath
  2336.           this panel. Some functions include examples, but the best examples
  2337.           are provided in the host mode script (HOST.CMD) provided with
  2338.           LiveWire 2.2.
  2339.  
  2340.  REXX extensions
  2341.           REXX scripts are plain ASCII text, and must end with the .CMD
  2342.           extension. LiveWire registers itself as a sub-command handler for
  2343.           REXX programs run inside LiveWire. LiveWire passes on any commands
  2344.           that are not valid functions to the OS/2 command interpreter.
  2345.           Standard REXX output, tracing output, and error output are mapped to
  2346.           LiveWire's terminal screen. In addition, LiveWire redirects the
  2347.           standard REXX output command SAY to to the LiveWire terminal screen.
  2348.  
  2349.           REXX scripts run from inside LiveWire can be further extended by
  2350.           third party extensions in order to add features such as
  2351.           multi-threading or PM interfaces.
  2352.           This manual does not include a complete description of the REXX
  2353.           scripting language. More information on the REXX scripting language
  2354.           is distributed with OS/2 as the INF file "REXX Information" normally
  2355.           kept in the Information folder.
  2356.  
  2357.  Script commands quick reference    64/2 
  2358.  
  2359. Script commands quick reference
  2360.  
  2361. The following are all LiveWire-defined script functions and attributes. This
  2362. page is for quick reference only, see full documentation on each function and
  2363. attribute for more information.
  2364.  
  2365. Functions defined by LiveWire
  2366.  
  2367. AnsiColorLW(fg, bg)
  2368. ClrScrLW()
  2369. DelayLW(ms)
  2370. DialLW(markstring)
  2371. DiseLW(string)
  2372. DispLW(string)
  2373. DoMacroLW(keyname)
  2374. DumpScreenLW(filename)
  2375. FindLW(string, string, ...)
  2376. FlushBufferLW()
  2377. GetKeyLocalLW()
  2378. GetKeyLW()
  2379. GetKeyRemoteLW()
  2380. GetLW(attribute)
  2381. GetStrLocalLW(string, maxlen)
  2382. GetStrLW(string, maxlen)
  2383. GetStrRemoteLW(string, maxlen)
  2384. HangUpLW()
  2385. LogLW(string)
  2386. ReceiveFilesLW(protocol, path)
  2387. SendBreakLW()
  2388. SendFilesLW(protocol, filelist)
  2389. SetLW(attribute, attribute_value)
  2390. SleepLW(seconds)
  2391. WaitTimeLW(hr, min)
  2392.  
  2393. Attributes for GetLW and SetLW
  2394.  
  2395. BgColor             BSisDEL             Capture
  2396.  CaptureFile        ConnectPopup        ConnectTimeout
  2397.  CurrentDir         CurrentDisk         CursorX
  2398.  CursorY            DataBits            DialerBits
  2399.  DialerDuplex       DialerEmulation     DialerInfoFile
  2400.  DialerLastCall     DialerName          DialerNumber
  2401.  DialerOnStartup    DialerParity        DialerPassword
  2402.  DialerPhoneNumber  DialerProtocol      DialerScriptFile
  2403.  DialerSpeed        DialerStop          DialerTotalCalls
  2404.  DLDir              DoorWay             DumpFile
  2405.  Echo               EchoBack            Editor
  2406.  Emulation          FgColor             IgnoreCarrier
  2407.  Linefeeds          LocalOnly           LocalOnly
  2408.  LockedPort         Log                 LogFile
  2409.  MacroFile          Music               Online
  2410.  Pacing             Parity              PhoneFile
  2411.  PipeName           Port                Printer
  2412.  RedialWait         RtsCts              ScrollBack
  2413.  Speed              StatusLine          StopBits
  2414.  TimeOut            ULDir               XlateFile
  2415.  XonXoff
  2416.  
  2417.  GetLW(attribute)    65/2 
  2418.  
  2419. GetLW(attribute)
  2420.  
  2421.           GetLW takes an attribute as an argument and returns the current
  2422.           actual value of the passed attribute.  If the value of the attribute
  2423.           is undefined, then the return value is the empty string or "".
  2424.  
  2425.  SetLW(attribute, attribute_value)    66/2+
  2426.  
  2427. SetLW(attribute,attribute_value)
  2428.  
  2429.           SetLW sets a majority of LiveWire program attributes.  It takes an
  2430.           attribute and a corresponding attribute value as arguments.  A call
  2431.           to SetLW will attempt to set the passed LiveWire program attribute to
  2432.           the passed attribute value. If SUCCESS, the return value is the empty
  2433.           string.
  2434.  
  2435.           Listed as sub-entries of this command are all the attribute that are
  2436.           Getable and Setable in LiveWire.
  2437.  
  2438.  TimeOut    67/3 
  2439.  
  2440. TimeOut
  2441.  
  2442.           TimeOut - represents the LiveWire timeout value in seconds.  TimeOut
  2443.           must be set to an integer value. 
  2444.  
  2445.           Example:  SetLW( TimeOut, 45 ); 
  2446.  
  2447.           This sets TimeOut to 45 seconds. If TimeOut is set to 0, then there
  2448.           is no timeout effect in LiveWire at all.
  2449.  
  2450.  Echoback    68/3 
  2451.  
  2452. Echoback
  2453.  
  2454.           EchoBack - determines whether or not input received over the
  2455.           communications line should be echoed back.
  2456.  
  2457.           Example: SetLW( EchoBack, On );
  2458.           This toggles EchoBack to ON.  Similarly, it may be set to OFF with
  2459.           SetLW( EchoBack, Off ); 
  2460.  
  2461.           Integer values may also replace the arguments, where 1=ON and 0=OFF. 
  2462.           By default, EchoBack is OFF.
  2463.  
  2464.  FgColor    69/3 
  2465.  
  2466. FgColor
  2467.  
  2468.           FgColor - represents the current local LiveWire foreground color. 
  2469.           May be set with colors in the range from 0 to 15, inclusive, integers
  2470.           values only. 
  2471.  
  2472.           Example:  SetLW( FgColor, 8 );
  2473.           This set the foreground color to Dark Grey. The following is the
  2474.           foreground coloring scheme:
  2475.  
  2476.           Value      Color
  2477.           -----      ----
  2478.           0          Black
  2479.           1          Blue
  2480.           2          Green
  2481.           3          Cyan
  2482.           4          Red
  2483.           5          Magenta
  2484.           6          Brown
  2485.           7          White
  2486.           8          Dark Grey
  2487.           9          Light Blue
  2488.           10         Bright Green
  2489.           11         Bright Blue    
  2490.           12         Bright Red
  2491.           13         Bright Magenta
  2492.           14         Yellow
  2493.           15         White
  2494.  
  2495.  BgColor    70/3 
  2496.  
  2497. BgColor
  2498.  
  2499.           BgColor - represents the current local LiveWire background color. 
  2500.           May be set with the same values as FgColor, except only the range
  2501.           from 1 to 7. 
  2502.  
  2503.           Note:  Clearing the screen after modifying background colors will
  2504.           cause the entire screen to immediately change to that background
  2505.           color. 
  2506.  
  2507.  CursorX    71/3 
  2508.  
  2509. CursorX
  2510.  
  2511.           CursorX - the cursor X position, where X_Coordinate is an integer
  2512.           value in the range 1 to 80, inclusive.
  2513.  
  2514.  CursorY    72/3 
  2515.  
  2516. CursorY
  2517.  
  2518.           CursorY - the cursor position, where Y_Coordinate is an integer value
  2519.           in the range 1 to screen length, inclusive.
  2520.  
  2521.  Online    73/3 
  2522.  
  2523. Online
  2524.  
  2525.           Online - determines whether or not LiveWire is currently online.  If
  2526.           online, then the return value is 1.  Otherwise, if not online, then
  2527.           the return value is 0.  Note: This attribute is only defined for
  2528.           GetLW.
  2529.  
  2530.  CurrentDir    74/3 
  2531.  
  2532. CurrentDir
  2533.  
  2534.           CurrentDir - represents the current directory. 
  2535.           Example: SetLW( CurrentDir, "C:\LiveWire\Info" );
  2536.  
  2537.  CurrentDisk    75/3 
  2538.  
  2539. CurrentDisk
  2540.  
  2541.           CurrentDisk - represents the current default disk drive.
  2542.           Example:  SetLW( CurrentDisk, "D:" );.
  2543.  
  2544.  Emulation    76/3 
  2545.  
  2546. Emulation
  2547.  
  2548.           Emulation - represents the current emulation. 
  2549.           Emulation values are as follows:  0=TTY, 1=ANSI-BBS, 2=OS2YOU,
  2550.           3=VT-102 4=0+ Avatar.
  2551.  
  2552.           Example: SetLW( Emulation, 1 );
  2553.           This sets the current emulation to ANSI-BBS.
  2554.  
  2555.  Capture    77/3 
  2556.  
  2557. Capture
  2558.  
  2559.           Capture - determines whether or not LiveWire should capture sessions.
  2560.           May be set with ON/OFF, 1/0, where 1=Start Capture and 0=Stop
  2561.           capture.
  2562.  
  2563.           A third optional parameter (only available with ON setting) specifies
  2564.           the file to capture to.
  2565.  
  2566.           Note: When used with GetLW, only returns 1 or 0.
  2567.           Example: SetLW(Capture, ON);
  2568.           Example: SetLW(Capture, ON, "Cap.Fil");
  2569.           Example: SetLW(Capture, OFF);
  2570.  
  2571.  CaptureFile    78/3 
  2572.  
  2573. CaptureFile
  2574.  
  2575.           CaptureFile - represents the name of the current capture file.
  2576.  
  2577.  LogFile    79/3 
  2578.  
  2579. LogFile
  2580.  
  2581.           LogFile - represents the name of the current log file.
  2582.  
  2583.  Log    80/3 
  2584.  
  2585. Log
  2586.  
  2587.           Log - determines whether or not LiveWire's log feature is active.
  2588.  
  2589.  Echo    81/3 
  2590.  
  2591. Echo
  2592.  
  2593.           Echo - determines whether or not the echo (display) of key presses is
  2594.           on or off. May be set with attribute values On or Off, 1 or 0, True
  2595.           or False.  Note: When used with GetLW, only returns 1 or 0.
  2596.  
  2597.           Example: SetLW(Echo, On);
  2598.  
  2599.  Linefeeds    82/3 
  2600.  
  2601. Linefeeds
  2602.  
  2603.           Linefeeds - determines whether or not automatic line feeds is on or
  2604.           off. May be set with attribute values On or Off, 1 or 0, True or
  2605.           False.  Note: when used with GetLW, only returns 1 or 0.
  2606.  
  2607.  RtsCts    83/3 
  2608.  
  2609. RtsCts
  2610.  
  2611.           RtsCts - determines whether or not RTS/CTS flow control is on or off. 
  2612.           May be set with attribute values On or Off, 1 or 0, True or False. 
  2613.           Note:  When used with GetLW, only returns 1 or 0.
  2614.  
  2615.  StatusLine    84/3 
  2616.  
  2617. StatusLine
  2618.  
  2619.           StatusLine - determines whether or not the status line is turned on
  2620.           or off. Maybe set with attribute values On or Off, 1 or 0, True or
  2621.           False. Note:  When used with GetLW, only returns 1 or 0.
  2622.  
  2623.  DoorWay    85/3 
  2624.  
  2625. Doorway
  2626.  
  2627.           Doorway - determines whether or not doorway mode is on or off.  May
  2628.           be set with attribute values On or Off, 1 or 0, True or False.  Note: 
  2629.           When used with GetLW, only returns 1 or 0.
  2630.  
  2631.  Printer    86/3 
  2632.  
  2633. Printer
  2634.  
  2635.           Printer - determines whether or not printer capture is on or off. 
  2636.           May be set with attribute values On or Off, 1 or 0, True or False. 
  2637.           Note:  When used with GetLW, only returns 1 or 0.
  2638.  
  2639.  BSisDEL    87/3 
  2640.  
  2641. BSisDEL
  2642.  
  2643.           BSisDEL - determines whether or not the backspace key is equated with
  2644.           the DEL key.  May be set with attribute values On or Off, 1 or 0,
  2645.           True or False. By default, BSisDel is set OFF.  Note:  When used with
  2646.           GetLW, only returns 1 or 0.
  2647.  
  2648.  PhoneFile    88/3 
  2649.  
  2650. PhoneFile
  2651.  
  2652.           PhoneFile - represents the current phone directory file. 
  2653.  
  2654.  MacroFile    89/3 
  2655.  
  2656. MacroFile
  2657.  
  2658.           MacroFile - represents the current macro file.
  2659.  
  2660.  XlateFile    90/3 
  2661.  
  2662. XlateFile
  2663.  
  2664.           XlateFile - represents the current translation table file.
  2665.  
  2666.  Port    91/3 
  2667.  
  2668. Port
  2669.  
  2670.           Port - represents the current communications port being used.
  2671.  
  2672.  Speed    92/3 
  2673.  
  2674. Speed
  2675.  
  2676.           Speed - represents the current modem speed.  May be set with any
  2677.           common baud rate. 
  2678.  
  2679.           Example:  SetLW(Speed, 14400);
  2680.           This sets the  modem speed to 14000 baud.
  2681.  
  2682.  Parity    93/3 
  2683.  
  2684. Parity
  2685.  
  2686.           Parity - represents the current parity checking in effect.
  2687.  
  2688.           Parity values are as follows:
  2689.           0=No Parity
  2690.           1=Even Parity
  2691.           2=Odd Parity
  2692.  
  2693.  DataBits    94/3 
  2694.  
  2695. DataBits
  2696.  
  2697.           DataBits - represents the number of databits (7 or 8) used in
  2698.           communication. The number of databits must be integer values of
  2699.           either 7 or 8.
  2700.  
  2701.  StopBits    95/3 
  2702.  
  2703. StopBits
  2704.  
  2705.           StopBits - represents the number of stop bits used in communication.
  2706.           The number of stop bits must be integer values of either 1 or 2. 
  2707.  
  2708.  LockedPort    96/3 
  2709.  
  2710. LockedPort
  2711.  
  2712.           LockedPort - determines whether or not the modem baud rate is locked.
  2713.           May be set with attribute values On or Off, 1 or 0, True or False. 
  2714.           Note: When used with GetLW, only returns 1 or 0.
  2715.  
  2716.  PipeName    97/3 
  2717.  
  2718. PipeName
  2719.  
  2720.           PipeName - represents the name of the current named pipe.
  2721.  
  2722.  XonXoff    98/3 
  2723.  
  2724. XonXoff
  2725.  
  2726.           XonXoff - determines whether or not flow control is on or off.  May
  2727.           be set with attribute values On or Off, 1 or 0, True or False.  Note: 
  2728.           When used with GetLW, only returns 1 or 0.
  2729.  
  2730.  IgnoreCarrier    99/3 
  2731.  
  2732. IgnoreCarrier
  2733.  
  2734.           IgnoreCarrier - determines whether or not to ignore carrier on
  2735.           downloads and uploads.  May be set with attribute values On or Off, 1
  2736.           or 0, True or False. Note: When used with GetLW, only returns 1 or 0.
  2737.  
  2738.  ConnectPopup    100/3 
  2739.  
  2740. ConnectPopup
  2741.  
  2742.           ConnectPopup - determines whether or not to popup a message when
  2743.           connect to other host.  May be set with attribute values On or Off, 1
  2744.           or 0, True or False. Note:  When used with GetLW, only returns 1 or
  2745.           0.
  2746.  
  2747.  Music    101/3 
  2748.  
  2749. Music
  2750.  
  2751.           Music - determines whether or not music is on or off.  May be set
  2752.           with attribute values On or Off, 1 or 0, True or False.  By default,
  2753.           music is ON.  Note: When used with GetLW, only returns 1 or 0.
  2754.  
  2755.  DialerOnStartup    102/3 
  2756.  
  2757. DialerOnStartup
  2758.  
  2759.           DialerOnStartup - determines whether or not to dial a specified phone
  2760.           directory entry immediately upon LiveWire startup. 
  2761.  
  2762.  ScrollBack    103/3 
  2763.  
  2764. ScrollBack
  2765.  
  2766.           ScrollBack - determines whether or not the scroll back buffer is on
  2767.           or off. May be set with attribute values On or Off, 1 or 0, True or
  2768.           False. By default scrollback, is ON.  Note:  When used with GetLW,
  2769.           only returns 1 or 0.
  2770.  
  2771.  ConnectTimeout    104/3 
  2772.  
  2773. ConnectTimeout
  2774.  
  2775.           ConnectTimeout - represents the maximum amount of time LiveWire will
  2776.           wait to connect to each computer system dialed.
  2777.  
  2778.  RedialWait    105/3 
  2779.  
  2780. RedialWait
  2781.  
  2782.           RedialWait - represents the amount of time LiveWire will wait between
  2783.           dialing attempts. 
  2784.  
  2785.  Pacing    106/3 
  2786.  
  2787. Pacing
  2788.  
  2789.           Pacing - sets the character inter-pacing value.  If the pacing value
  2790.           is set to 0, then pacing has no effect.  Must be set with integer
  2791.           values where the pacing rate is effectively measured in milliseconds.
  2792.  
  2793.  Editor    107/3 
  2794.  
  2795. Editor
  2796.  
  2797.           Editor - represents the full path of the current default LiveWire
  2798.           text editor.
  2799.  
  2800.  ULDir    108/3 
  2801.  
  2802. ULDir
  2803.  
  2804.           ULDir - represents the directory where uploaded files will go. If
  2805.           this value is "", then the upload directory is the current directory.
  2806.  
  2807.  DLDir    109/3 
  2808.  
  2809. DLDir
  2810.  
  2811.           DLDir - represents the directory where downloaded files will go. If
  2812.           this value is "", then the download directory is the current
  2813.           directory.
  2814.  
  2815.  DumpFile    110/3 
  2816.  
  2817. DumpFile
  2818.  
  2819.           DumpFile - represents current dump file name including path.
  2820.  
  2821.  MacroFile    111/3 
  2822.  
  2823. MacroFile
  2824.  
  2825.           MacroFile - represents the name of the current macro file including
  2826.           path.
  2827.  
  2828.  LocalOnly    112/3 
  2829.  
  2830. LocalOnly
  2831.  
  2832.           LocalOnly - determines whether or not your script should send output
  2833.           to the modem.  When set to 0, Off, or False output from your script
  2834.           may be sent to the modem.  If set to 1, On, or True output is
  2835.           restricted to the local system. By default, LocalOnly is set to OFF. 
  2836.           Note: When used with GetLW, only returns 1 or 0.
  2837.  
  2838.  DialerNumber    113/3 
  2839.  
  2840. DialerNumber
  2841.  
  2842.           DialerNumber - The current dialing entry number being modified. If
  2843.           the script was run automatically from the dialer after connecting,
  2844.           this attribute will be set to the dialing entry connected to.
  2845.  
  2846.  DialerName    114/3 
  2847.  
  2848. DialerName
  2849.  
  2850.           DialerName - The name of the current entry in the dialing directory.
  2851.  
  2852.  DialerPhoneNumber    115/3 
  2853.  
  2854. DialerPhoneNumber
  2855.  
  2856.           DialerPhoneNumber - The number of the current entry in the dialing
  2857.           directory.
  2858.  
  2859.  DialerInfoFile    116/3 
  2860.  
  2861. DialerInfoFile
  2862.  
  2863.           DialerInfoFile - The name of the comments/information file of the
  2864.           current entry.
  2865.  
  2866.  DialerScriptFile    117/3 
  2867.  
  2868. DialerScriptFile
  2869.  
  2870.           DialerScriptFile - The name of the script file of the current entry.
  2871.  
  2872.  DialerSpeed    118/3 
  2873.  
  2874. DialerSpeed
  2875.  
  2876.           DialerSpeed - The communications speed of the current entry.
  2877.  
  2878.  DialerParity    119/3 
  2879.  
  2880. DialerParity
  2881.  
  2882.           DialerParity - The parity of the current entry.  (N, E, or O)
  2883.  
  2884.  DialerBits    120/3 
  2885.  
  2886. DialerBits
  2887.  
  2888.           DialerBits - The data bits of the current entry. (7 or 8)
  2889.  
  2890.  DialerStop    121/3 
  2891.  
  2892. DialerStop
  2893.  
  2894.           DialerStop - The stop bits of the current entry. (1 or 2)
  2895.  
  2896.  DialerDuplex    122/3 
  2897.  
  2898. DialerDuplex
  2899.  
  2900.           DialerDuplex - The duplex of the current entry. (F=Full, H=Half)
  2901.  
  2902.  DialerPassword    123/3 
  2903.  
  2904. DialerPassword
  2905.  
  2906.           DialerPassword - The password of the current entry.
  2907.  
  2908.  DialerProtocol    124/3 
  2909.  
  2910. DialerProtocol
  2911.  
  2912.           DialerProtocol - The hotkey (highlighted character in the menu) of
  2913.           the protocol of the current entry. (EG: Zmodem is Z, Xmodem-1K is 1)
  2914.  
  2915.  DialerEmulation    125/3 
  2916.  
  2917. DialerEmulation
  2918.  
  2919.           DialerEmulation - The emulation of the current entry.
  2920.  
  2921.  DialerLastCall    126/3 
  2922.  
  2923. DialerLastCall
  2924.  
  2925.           DialerLastCall - The date of the last call of the current entry.
  2926.  
  2927.  DialerTotalCalls    127/3 
  2928.  
  2929. DialerTotalCalls
  2930.  
  2931.           DialerTotalCalls - The number of total calls to the current entry.
  2932.  
  2933.  DispLW(string)    128/2 
  2934.  
  2935. DispLW(string)
  2936.  
  2937.           Disp(string) - displays a string locally (i.e. does not send it over
  2938.           the modem), where <string> is a string of text enclosed in a pair of
  2939.           quotes or the name of a string variable. 
  2940.  
  2941.           The passed string may include any special control characters
  2942.           following special characters, for example: 
  2943.           ^M = carriage return
  2944.           ^J = line feed
  2945.           ^G = Bell
  2946.  
  2947.           ^M^J would be a carriage return immediately followed by a line feed.
  2948.  
  2949.           Example:
  2950.           DispLW("This will display a string and drop down to the next
  2951.           line^M^J");
  2952.  
  2953.  SendLW(string)    129/2 
  2954.  
  2955. SendLW(string)
  2956.  
  2957.           SendLW(string) - sends a string over the modem, but does not display
  2958.           it to the screen, where <string> is a string of text enclosed in a
  2959.           pair of quotes or the name of a string variable. 
  2960.  
  2961.           The passed string may include any special control characters
  2962.           following special characters, for example: 
  2963.           ^M = carriage return (or ENTER)
  2964.           ^J = line feed
  2965.           ^G = Bell
  2966.  
  2967.           ^M^J would be a carriage return immediately followed by a line feed.
  2968.  
  2969.           Example:
  2970.           DispLW("This will send a string to the modem and press [ENTER]^M");
  2971.  
  2972.  DiseLW(string)    130/2 
  2973.  
  2974. DiseLW(string)
  2975.  
  2976.           DiseLW(str) - sends a string over the modem and displays it locally
  2977.           as well, where <str> is a string of text enclosed in a pair of quotes
  2978.           or the name of a string variable.
  2979.  
  2980.           The passed string may include any special control characters
  2981.           following special characters, for example:
  2982.           ^M = carriage return (or ENTER)
  2983.           ^J = line feed
  2984.           ^G = Bell
  2985.  
  2986.           ^M^J would be a carriage return immediately followed by a line feed.
  2987.  
  2988.           Example:
  2989.           DispLW("This will send a string to the modem and display it on the
  2990.           LiveWire screen^M");
  2991.  
  2992.  FindLW(string, string, )    131/2 
  2993.  
  2994. FindLW(string, string, ...)
  2995.  
  2996.           FindLW(string, string, ... ) - Waits until one of the strings
  2997.           <string> is found in the information being received over the modem,
  2998.           where <string> is a string of text enclosed in a pair of quotes or
  2999.           the name of a string variable. Find may look for up to 10 strings. 
  3000.           The command fails if it cannot find one of the strings in the amount
  3001.           of time specified in the TIMEOUT variable.  Upon timeout, FindLW
  3002.           returns the string "TIMEOUT", otherwise it returns the string it
  3003.           found. Note that if timeout is zero, FindLW will not timeout.
  3004.  
  3005.           Note:  The passed strings may include the following special
  3006.           characters:  ^M = carriage return, ^J = line feed, and ^G = Bell. 
  3007.           For example, ^M^J would be a carriage return immediately followed by
  3008.           a line feed.
  3009.  
  3010.  GetKeyLW()    132/2 
  3011.  
  3012. GetKeyLW()
  3013.  
  3014.           GetKeyLW() - returns a single keystroke of input from either the
  3015.           local end or remote computer.
  3016.  
  3017.  GetKeyLocalLW()    133/2 
  3018.  
  3019. GetKeyLocalLW()
  3020.  
  3021.           GetKeyLocalLW() - returns a singe keystroke of input from the local
  3022.           end of LiveWire.
  3023.  
  3024.  GetKeyRemoteLW()    134/2 
  3025.  
  3026. GetKeyRemoteLW()
  3027.  
  3028.           GetKeyRemoteLW( ) - returns a single keystroke of input from the
  3029.           remote computer.
  3030.  
  3031.  GetStrLW(string, maxlen)    135/2 
  3032.  
  3033. GetStrLW(string, maxlen)
  3034.  
  3035.           GetStrLW(string, maxlen) - receives a full string from either the
  3036.           local or remote end and returns a string typed or edited by the user. 
  3037.           The string is ended when <ENTER> is pressed. If a string <string> is
  3038.           specified, the string appears for the user to edit. The string will
  3039.           not be allowed to exceed the maximum length specified by <maxlen>.
  3040.           The size of the passed string <string> cannot exceed the length.
  3041.           specified by <maxlen>.  By default, <maxlen> is 78.
  3042.  
  3043.           Example: 
  3044.           Name=GetStrLW("Les",15);
  3045.  
  3046.           Would display the name "Les" for editing. Up to a maximum of 15
  3047.           characters can be entered. When <ENTER> is pressed the variable
  3048.           "Name" gets the edited string.
  3049.  
  3050.  GetStrLocalLW(string, maxlen)    136/2 
  3051.  
  3052. GetStrLocalLW(string, maxlen)
  3053.  
  3054.           GetStrLocalLW(string, maxlen ) - this command is similar to GetStrLW
  3055.           except that GetStrLocalLW gets a string only from the local keyboard.
  3056.           Also, the editing provided is much more powerful than GetStrLW since
  3057.           it allows full editing of the variable with arrow, insert, and delete
  3058.           keys.
  3059.  
  3060.  GetStrRemoteLW(string, maxlen)    137/2 
  3061.  
  3062. GetStrRemoteLW(string, maxlen)
  3063.  
  3064.           GetStrRemoteLW(string, maxlen) - similar to GetStrLW, except this
  3065.           command only receives a string from the remote computer.
  3066.  
  3067.  DialLW(markstring)    138/2 
  3068.  
  3069. DialLW(markstring)
  3070.  
  3071.           DialLW(markstring) - marks and dials a range of entries based upon a
  3072.           given mark string, specified by the string <markstring>. The mark
  3073.           string allows you to mark entries by name, part of a name, or entry
  3074.           number. Here are some examples:
  3075.  
  3076.           1,10,50,3           Marks entries 1, 10, 50, and 3
  3077.           1,5..20             Marks entries 1, and all entries 5 through 20,
  3078.                               inclusive.
  3079.           1..20,25..200       Marks entries 1 through 20 and 25 through 200,
  3080.                               inclusive.
  3081.           DataMirage          Marks all entries that contain "DataMirage"
  3082.           Data                Marks all entries that contain "Data".  Note that
  3083.                               this will match entries such as "DataMirage", The
  3084.                               DATA Line", and "My Data". Also, this is case
  3085.                               insensitive.
  3086.           1,Data,5..20        Marks entry 1, all entries containing "Data", and
  3087.                               entries 5 through 20, inclusive.
  3088.  
  3089.  ClrScrLW()    139/2 
  3090.  
  3091. ClrScrLW()
  3092.  
  3093.           ClrScrLW() - clears the local screen.
  3094.  
  3095.  SendBreakLW()    140/2 
  3096.  
  3097. SendBreakLW()
  3098.  
  3099.           SendBreakLW() - sends a break signal over the modem for 1/4 of a
  3100.           second.
  3101.  
  3102.  SendFilesLW(protocol, filelist)    141/2 
  3103.  
  3104. SendFilesLW(protocol, filelist)
  3105.  
  3106.           SendFilesLW(protocol, filelist) 
  3107.  
  3108.           Sends (uploads) one or more files over the modem using the specified
  3109.           protocol, where <protocol> is a string variable that should contain a
  3110.           single character which is the hotkey of the protocol to use.  The
  3111.           hotkeys are the letters that are highlighted in the protocol listing
  3112.           when you press <PgUp>.  For example, Zmodem would be Z.  Xmodem would
  3113.           be X.  Xmodem-1K would be 1.
  3114.  
  3115.           <filelist> is a list of quote-enclosed files and their paths to send
  3116.           all in one string. Long filenames and filenames with spaces are
  3117.           accepted. If you wish to send only one file, there is no need to
  3118.           enclose the file in double quotes. Wildcards are not accepted.
  3119.  
  3120.           For example:
  3121.           SendFilesLW(Z, '"C:\COMMAND.COM" "F:\LW22\LW22.EXE"');
  3122.           SendFilesLW(Z, 'C:\AUTOEXEC.BAT');
  3123.  
  3124.           Returns "0" on success, otherwise failure.
  3125.           Specific failure codes may be added in future versions of LiveWire.
  3126.  
  3127.  ReceiveFilesLW(protocol, path)    142/2 
  3128.  
  3129. ReceiveFilesLW(protocol, path)
  3130.  
  3131.           ReceiveFilesLW(protocol, path) 
  3132.  
  3133.           Receives (downloads) one or more files over the modem using the
  3134.           specified protocol, where <protocol> is a string variable that should
  3135.           contain a single character which is the hotkey of the protocol to
  3136.           use.  The hotkeys are the letters that are highlighted in the
  3137.           protocol listing when you press <PgDn>.  For example, Zmodem would be
  3138.           Z.  Xmodem would be X.  Xmodem-1K would be 1. 
  3139.  
  3140.           <path> is the directory to place the received files into for batch
  3141.           protocols. For single-file protocols (Xmodem, Xmodem-1K, Xmodem CRC),
  3142.           <path> is the full filespec of the file being received. If <path> is
  3143.           the empty string (""), received files are placed in the default
  3144.           download directory. 
  3145.  
  3146.           For example:
  3147.           ReceiveFilesLW(Z, "");
  3148.           ReceiveFilesLW(Z, "C:\DOS");
  3149.           ReceiveFilesLW(X, "C:\DOS\COMMAND.COM");
  3150.  
  3151.           Returns "0" on success, otherwise failure.
  3152.           Specific failure codes may be added in future versions of LiveWire.
  3153.  
  3154.  AnsiColorLW(fg, bg)    143/2 
  3155.  
  3156. AnsiColorLW(fg, bg)
  3157.  
  3158.           AnsiColorLW(fg,bg) - sends an ANSI code over the modem that changes
  3159.           the remote terminal color. <fg> is the foreground color. <bg> is the
  3160.           background color.
  3161.  
  3162.  DumpScreenLW(filename)    144/2 
  3163.  
  3164. DumpScreenLW(filename)
  3165.  
  3166.           DumpScreenLW(filename) - dumps the current screen to <filename>, the
  3167.           specified dump file.
  3168.  
  3169.  ExitLW()    145/2 
  3170.  
  3171. ExitLW()
  3172.  
  3173.           ExitLW() - exits the LiveWire program.
  3174.  
  3175.  DelayLW(ms)    146/2 
  3176.  
  3177. DelayLW(ms)
  3178.  
  3179.           DelayLW(ms) - delays for <ms> milliseconds before resuming the
  3180.           script.
  3181.  
  3182.  SleepLW(seconds)    147/2 
  3183.  
  3184. SleepLW(seconds)
  3185.  
  3186.           SleepLW(seconds) - sleeps (does nothing) for <seconds> amount of time
  3187.           before resuming the script.
  3188.  
  3189.  WaitTimeLW(hr, min)    148/2 
  3190.  
  3191. WaitTimeLW(hr, min)
  3192.  
  3193.           WaitTime(hr, min) - waits until the current time is <hr>:<mn> (in 24
  3194.           hour military time) before resuming the script. During the wait time,
  3195.           the session continues. Therefore, this command can be used to capture
  3196.           data from a start time to end time.
  3197.  
  3198.  HangUpLW()    149/2 
  3199.  
  3200. HangUpLW()
  3201.  
  3202.           HangUpLW() - attempts to disconnect the current modem session.
  3203.  
  3204.           Returns "1" on success (modem reports offline status), "0" on failure
  3205.           (modem reports online status).
  3206.  
  3207.  DoMacroLW()    150/2 
  3208.  
  3209. DoMacroLW()
  3210.  
  3211.           DoMacroLW(<key name>) - executes a macro given a key name.
  3212.  
  3213.           Example:
  3214.           DoMacroLW("F1");
  3215.           DoMacroLW("ALT-X");
  3216.  
  3217.           Warning: This function has had minimal testing and is not guaranteed
  3218.           to work except for macros containing strictly ASCII text or the
  3219.           {PASSWORD} command. All other macro commands may or may not work.
  3220.  
  3221.  FlushBufferLW()    151/2 
  3222.  
  3223. FlushBufferLW()
  3224.  
  3225.           FlushBufferLW() - Flushes the incoming and outgoing data buffers.
  3226.  
  3227.  LogLW()    152/2 
  3228.  
  3229. LogLW()
  3230.  
  3231.           LogLW(<str>) - Creates an entry in the log file. The time and date
  3232.           are automatically stamped.
  3233.  
  3234.           Example:
  3235.           LogLW("Hanging up");
  3236.           LogLW("Phone rang");
  3237.  
  3238.  Learning scripts    153/1+
  3239.  
  3240. Learning scripts
  3241.  
  3242.           LiveWire has the capability to record part or all of a communications
  3243.           session and play it back automatically. This is called script learn.
  3244.  
  3245.           LiveWire accomplishes this "recording" by assuming that the service
  3246.           you are connected to will be sending a prompt (eg: Enter Your Name or
  3247.           Press Any Key...) and that you will respond by typing a response and
  3248.           pressing ENTER. LiveWire remembers what you type at each prompt and
  3249.           responds in the same manner next time it sees these prompts.
  3250.  
  3251.           The following runs through an example learning session:
  3252.           The first thing you must do is find a service you want to call in
  3253.           your phone directory and put a filename in the "Script" field. To
  3254.           edit this entry press "E" while the highlight bar is on the entry.
  3255.           When the edit window appears, move your highlight bar to the entry
  3256.           "Script" and press ENTER. Now type a filename, ending with the
  3257.           extension .CMD, into this field and press ENTER. Then press Esc to
  3258.           save this entry.
  3259.           Now, dial the service. Note that as you dial an "L" appears next to
  3260.           the entry where a check mark normally appears. This means that
  3261.           LiveWire will automatically start learning as soon as you get onto
  3262.           the service.
  3263.           Logon normally to the service, but take care to note of how much of
  3264.           your logon you want LiveWire to remember. For example, on most
  3265.           services you would only need LiveWire to remember when you type your
  3266.           name and password. Beyond this (reading bulletins and messages) the
  3267.           service you call probably changes daily. If so, LiveWire will become
  3268.           confused. It isn't smart enough to adapt to these changes.
  3269.           When you are ready to have LiveWire stop learning, look at the status
  3270.           line on your screen. It will tell you what keys you need to press to
  3271.           stop script learning.
  3272.  
  3273.           That's it! Next time you call the same service LiveWire should
  3274.           automatically replay what it learned, key for key. If for some reason
  3275.           LiveWire did not learn correctly or you made a mistake while it was
  3276.           learning you can change the name of the script filename in the phone
  3277.           book entry or erase the script file.
  3278.  
  3279.           TIPS FOR LEARNING:
  3280.           LiveWire makes the assumption that when you press ENTER you are
  3281.           finished typing so...
  3282.  
  3283.           - Press ENTER after each prompt
  3284.  
  3285.           - The use of hotkeys (selection of an option without having to press
  3286.           ENTER) may not work
  3287.  
  3288.  Editing a learned script file    154/2 
  3289.  
  3290. Editing a learned script file
  3291.  
  3292.           Editing a script file associated with a service in the dialer is
  3293.           simple. Go into the dialer and move the highlight bar to the service,
  3294.           then press the V (for View Script) key. After a few seconds an editor
  3295.           will come up with the learned script. 
  3296.  
  3297.           If you intend to fix the script, the first thing you need to know is
  3298.           at what point the script is failing. For example, if the script never
  3299.           responds to a "PASSWORD:" prompt then you know that it is not
  3300.           recognizing the prompt correctly.
  3301.  
  3302.           Move your cursor to the place in the script which has the command to
  3303.           find the password prompt. This may look like:
  3304.  
  3305.           FindLW("PASSWORD:");
  3306.  
  3307.           Any small difference in the actual prompt and the prompt LiveWire
  3308.           expects will cause a problem. Some things to look for are:
  3309.  
  3310.           + Time/Date dependent information is part of the prompt
  3311.           EG: "(23 minutes left) COMMAND:"
  3312.           this should be changed to "COMMAND:"
  3313.  
  3314.           + Spaces where they do not belong
  3315.  
  3316.           + Odd control (^) characters
  3317.  
  3318.           + Line noise
  3319.  
  3320.           + The system prompt changed since you learned the script!
  3321.  
  3322.  Host mode script    155/1 
  3323.  
  3324. Host mode script
  3325.  
  3326.           LiveWire 2.2 includes a Host Mode REXX script. The host mode script
  3327.           allows a computer to accept incoming calls. Callers can access the
  3328.           remote computer and do the following functions:
  3329.  
  3330.           - Transfer files
  3331.           - Send messages
  3332.           - Chat with you
  3333.  
  3334.           The host mode included is by intended for simple purposes only and is
  3335.           not robust or complete enough to serve as a full bulletin board or
  3336.           service. The host might be useful if you have a co-worker or friend
  3337.           who needs to call up to your system and get a file. In addition, he
  3338.           might also leave you a short message. The host could also be useful
  3339.           if you frequently exchange files from your home to the office via
  3340.           modem. The host is also a good example of how to program REXX scripts
  3341.           under LiveWire.
  3342.  
  3343.           To start the host most you must invoke it from LiveWire's command
  3344.           menu. The only parameter it recognizes is "LOCAL". If you type LOCAL
  3345.           as a parameter, the Host Mode will not wait for an incoming call, but
  3346.           instead will allow you to login locally.
  3347.  
  3348.           Host mode expects that the modem is setup correctly. Before running
  3349.           host mode make sure that:
  3350.           1. The modem is NOT in auto-answer mode
  3351.           2. The modem returns text response codes
  3352.           3. The modem speed is set properly
  3353.           4. If necessary, the modem's port speed is locked properly
  3354.  
  3355.           By default the host stores its messages and files in the LiveWire
  3356.           directory in the HSTFILES and HSTMSGS directories, which are
  3357.           automatically created by the script. These directories can be changed
  3358.           using the sysop menu inside the host. The default sysop password is
  3359.           "PASSWORD."
  3360.  
  3361.           If you have a special need that the host mode script does not
  3362.           address, feel free to modify the script. The script is not
  3363.           copyrighted, so any changes made may be re-distributed freely.
  3364.  
  3365.  Reporting bugs and suggestions    156/1 
  3366.  
  3367. Reporting bugs and suggestions
  3368.  
  3369.           DataMirage Software is committed to developing and delivering
  3370.           quality, bug-free software that meets your needs. Our bug database
  3371.           allows us to track each bug and suggestion individually. This bug
  3372.           database will be available in January 1994 to callers of the
  3373.           DataMirage BBS. Callers will be able to query for bugs and submit new
  3374.           bugs or suggestions directly to our database. Later, they can call
  3375.           back and view the progress being made on the bug and the release in
  3376.           which it will be fixed.
  3377.  
  3378.           We still accept bugs and suggestions from internet, CompUServe, and
  3379.           Prodigy. All bugs submitted must be in the format following. Bugs not
  3380.           in this format are often ambiguous, so please follow this format as
  3381.           closely as possible and provide as much detailed information as
  3382.           possible. Please note, only one bug or suggestion per form.
  3383.  
  3384.  Submission addresses:
  3385.           Internet  : 73631,1233@compuserve.com
  3386.           CompUServe          : 73631,1233
  3387.  
  3388.           LiveWire Bug Report
  3389.           585 Hyde Park Drive
  3390.           San Jose, CA 95136
  3391.  
  3392.           Bug Submission Form
  3393.  
  3394.           Submitter First Name :
  3395.           Submitter Last  Name :
  3396.           Submitter Phone #    :
  3397.           Submitter EMAIL      :
  3398.  
  3399.           One-line description :
  3400.  
  3401.           Severity of bug (1=who cares? - 4=critical crash) :
  3402.  
  3403.           Version of LiveWire :
  3404.  
  3405.           Steps to reproduce bug (many lines) :
  3406.           Complete description of bug or suggestion (many lines) :
  3407.           Have you tested this against other communications software?
  3408.  
  3409.           Describe your hardware setup, if necessary:
  3410.           - CPU
  3411.           - UART type
  3412.           - Modem manufacturer
  3413.           - Remote host
  3414.  
  3415.  Registration and support    157/1 
  3416.  
  3417. Registration and support
  3418.  
  3419. LiveWire 2.2 shareware license agreement
  3420.  
  3421. This agreement replaces all previous versions of LiveWire Communications
  3422. license agreements.
  3423.  
  3424. LiveWire is NOT free software! LiveWire is marketed under the shareware
  3425. marketing concept. You may use LiveWire for 30 days, after which you are
  3426. obligated to either register this software or discontinue use of the software.
  3427. The fee for registration is nominal and brings a lot of benefits. If you
  3428. register once, you will never have to buy another shareware version of
  3429. LiveWire. All future versions of LiveWire marketed under the shareware concept
  3430. can be registered with your serial number -- even if the registration prices go
  3431. up. You also get free (except for long distance or toll charges) support
  3432. through the DataMirage Bulletin Board System.
  3433.  
  3434. By using this software you are agreeing to the above terms.
  3435.  
  3436. Basic registration is $35
  3437. That includes:
  3438. - Your registration number
  3439. - Support through the DataMirage BBS
  3440.  
  3441. Extended registration is $45
  3442. That includes:
  3443. - Your registration number
  3444. - A registered copy of the latest version of LiveWire
  3445. - Support through the DataMirage BBS
  3446.  
  3447. Complete registration is $65
  3448. That includes:
  3449. - Your registration number
  3450. - A registered copy of the latest version of LiveWire Support
  3451. - Support through DataMirage BBS
  3452. - A laser printed manual, identical to the one provided with the 2.2 release
  3453.  
  3454. to register, mail the registration blank on the following page to:
  3455. DataMirage Software
  3456. 585 Hyde Park DriveSan Jose, CA 95136
  3457.  
  3458.  Registration by credit card    158/1 
  3459.  
  3460. Registration by credit card
  3461.  
  3462.           Starting with version 2.2 of LiveWire, credit card registration is
  3463.           available through the Public Shareware Library (PSL).
  3464.  
  3465.           CREDIT CARD ORDERS ONLY:
  3466.           You can order with MC, Visa, Amex, or Discover from Public (software)
  3467.           Library by calling 800-2424-PsL or 713-524-6394 or by FAX to
  3468.           713-524-6398 or by CIS Email to 71355,470 or by Internet Email to
  3469.           71355,470@compuserve.com. You can also mail credit card orders to PsL
  3470.           at P.O.Box 35705, Houston, TX 77235-5705.
  3471.  
  3472.           PsL can take orders via our 800#, non-800#, CIS#, and FAX#. Operators
  3473.           are available from 7:00 a.m. to 7:00 p.m. CST Monday-Friday and
  3474.           normally from 7:00 a.m. to 4:00 p.m. on weekends. 
  3475.  
  3476.           THE ABOVE NUMBERS ARE FOR ORDERS ONLY
  3477.  
  3478.           Any questions about the status of the shipment of the order, refunds,
  3479.           registration options, product details, technical support, volume
  3480.           discounts, dealer pricing, site licenses, etc, must be directed to:
  3481.  
  3482.           DataMirage Software
  3483.           585 Hyde Park Drive
  3484.           San Jose, CA 95136
  3485.           BBS #: 714-856-2071
  3486.  
  3487.           To insure that you get the latest version, PsL will notify DataMirage
  3488.           the day of your order and we will ship the product directly to you.
  3489.  
  3490.           Software Order #11300
  3491.  
  3492.  Registration form    159/1 
  3493.  
  3494. Registration form (print me!)
  3495.  
  3496. Filling out your name, address, and phone number is a
  3497. requirement. Your name will be used to personalize your serial
  3498. number.
  3499.  
  3500. Name      _________________________________
  3501.  
  3502.  Address
  3503.           _________________________________
  3504.  
  3505.           _________________________________
  3506.  
  3507.           _________________________________
  3508.  
  3509.  Phone # (_____)_________-________________
  3510.  
  3511.  QUANTITY
  3512.  (  ) $35 Basic Registration   = registration #
  3513.  
  3514.  (  ) $45 Extended Registration = registration # + newest version
  3515.  
  3516.  (  ) $65 Complete Registration = registration # + newest version + printed
  3517.  manual
  3518.  
  3519.    SUB TOTAL   ________
  3520.  
  3521.    $5 shipping  ________   (USA addresses excluded)
  3522.  
  3523.   + TAX (8.75%)  ________   (California residents only!)
  3524.  
  3525.    TOTAL COST  ________
  3526.  
  3527.  I only accept US currency, US money orders, and checks through the mail. If
  3528.  you send a purchase order, please make it clear where the invoice should be
  3529.  mailed.
  3530.  
  3531.